@swmansion/argent 0.18.1-next.0 → 0.18.1-next.2

package/dist/cli-cmds.mjs

@@ -204,7 +204,7 @@ function generateAuthToken() {
   return generateToken();
 }
 function findFreePort() {
-  return new Promise((resolve8, reject) => {
+  return new Promise((resolve9, reject) => {
     const srv = net.createServer();
     srv.listen(0, "127.0.0.1", () => {
       const addr = srv.address();
@@ -215,7 +215,7 @@ function findFreePort() {
       const port = addr.port;
       srv.close((err) => {
         if (err) reject(err);
-        else resolve8(port);
+        else resolve9(port);
       });
     });
     srv.on("error", reject);
@@ -316,7 +316,7 @@ function killSpawnedChild(child, pid) {
   }
 }
 function spawnToolsServer(paths, port, options = {}) {
-  return new Promise((resolve8, reject) => {
+  return new Promise((resolve9, reject) => {
     let logFd;
     try {
       fs.mkdirSync(STATE_DIR, { recursive: true });
@@ -353,7 +353,7 @@ function spawnToolsServer(paths, port, options = {}) {
         rl.close();
         child.stdout?.resume();
         child.stdout?.unref?.();
-        settle(() => resolve8({ port: actualPort, pid }));
+        settle(() => resolve9({ port: actualPort, pid }));
       }
     });
     child.on("error", (err) => {
@@ -879,9 +879,9 @@ async function tarball(sourcePath) {
   return tarPath;
 }
 function sha256File(filePath) {
-  return new Promise((resolve8, reject) => {
+  return new Promise((resolve9, reject) => {
     const hash = createHash2("sha256");
-    createReadStream(filePath).on("data", (chunk) => hash.update(chunk)).on("end", () => resolve8(hash.digest("hex"))).on("error", reject);
+    createReadStream(filePath).on("data", (chunk) => hash.update(chunk)).on("end", () => resolve9(hash.digest("hex"))).on("error", reject);
   });
 }
 async function uploadTar(tarPath, endpoint) {
@@ -1103,7 +1103,7 @@ function createToolsClient(options = {}) {
 import { copyFile, mkdir as mkdir4, readFile as readFile4, realpath, rm as rm3, stat as stat2, writeFile as writeFile4 } from "node:fs/promises";
 import { constants as fsConstants } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import { basename as basename3, dirname as dirname5, extname, isAbsolute as isAbsolute3, join as join8, normalize, sep as sep2 } from "node:path";
+import { basename as basename3, dirname as dirname5, extname, isAbsolute as isAbsolute3, join as join8, normalize, resolve as resolve5, sep as sep2 } from "node:path";
 import { createHash as createHash3 } from "node:crypto";
 
 // ../configuration-core/src/flags.ts
@@ -1493,6 +1493,18 @@ var CONFIG_SCHEMA = [
     // must precede dedup) and guards on the preset staying "union".
     merge: "union",
     example: '["~/DeviceSets/ci"]'
+  },
+  {
+    key: "recordings.directory",
+    description: "Directory where finished screen recordings (mp4) are saved on the client host. Absolute, `~`-prefixed, or relative to the project root (home dir when not in a project). Unset \u21D2 `.argent/recordings` under the project root.",
+    scopes: ["project", "global"],
+    parse: asString,
+    // A repo can pin where its recordings land; falls back to the user's global
+    // preference. Resolution happens on the client (the machine the mp4 is
+    // persisted to), so with a remote `argent link` tool-server it is the
+    // *client's* config that decides.
+    merge: "prioritize-local",
+    example: "~/Movies/argent"
   }
 ];
 function getConfigDefinition(key, registry = CONFIG_SCHEMA) {
@@ -1654,6 +1666,21 @@ function durableBaseDir() {
   return projectRoot ?? dirname5(argentHomeDir());
 }
 var ALLOWED_SAVE_DIRS = /* @__PURE__ */ new Set([normalize(".argent/recordings")]);
+var RECORDINGS_SAVE_DIR = normalize(".argent/recordings");
+function configuredRecordingsDir() {
+  let value;
+  try {
+    value = getConfigValueByKey("recordings.directory");
+  } catch {
+    return null;
+  }
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  if (trimmed === "") return null;
+  const home = dirname5(argentHomeDir());
+  const expanded = trimmed === "~" ? home : trimmed.startsWith("~/") || trimmed.startsWith(`~${sep2}`) ? join8(home, trimmed.slice(2)) : trimmed;
+  return resolve5(durableBaseDir(), expanded);
+}
 var MAX_DURABLE_BYTES = 2 * 1024 * 1024 * 1024;
 async function readCapped(res, cap) {
   const headers = res.headers;
@@ -1703,6 +1730,17 @@ function durableSaveTarget(handle) {
     return null;
   }
   if (!ALLOWED_SAVE_DIRS.has(rel)) return null;
+  if (rel === RECORDINGS_SAVE_DIR) {
+    const configured = configuredRecordingsDir();
+    if (configured) {
+      return {
+        dir: configured,
+        path: join8(configured, sanitizeSegment(handle.filename)),
+        base: configured,
+        rel: ""
+      };
+    }
+  }
   const base = durableBaseDir();
   const dir = join8(base, rel);
   return { dir, path: join8(dir, sanitizeSegment(handle.filename)), base, rel };
@@ -4438,14 +4476,14 @@ async function addSourceContext(frames) {
   return frames;
 }
 function getContextLinesFromFile(path16, ranges, output) {
-  return new Promise((resolve8) => {
+  return new Promise((resolve9) => {
     const stream = createReadStream2(path16);
     const lineReaded = createInterface2({
       input: stream
     });
     function destroyStreamAndResolve() {
       stream.destroy();
-      resolve8();
+      resolve9();
     }
     let lineNumber = 0;
     let currentRangeIndex = 0;
@@ -5742,9 +5780,9 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
     if (!waitUntil) return;
     if (this.disabled || this.optedOut) return;
     if (!this._waitUntilCycle) {
-      let resolve8;
+      let resolve9;
       const promise = new Promise((r2) => {
-        resolve8 = r2;
+        resolve9 = r2;
       });
       try {
         waitUntil(promise);
@@ -5752,7 +5790,7 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
         return;
       }
       this._waitUntilCycle = {
-        resolve: resolve8,
+        resolve: resolve9,
         startedAt: Date.now(),
         timer: void 0
       };
@@ -5776,12 +5814,12 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
     return cycle?.resolve;
   }
   async resolveWaitUntilFlush() {
-    const resolve8 = this._consumeWaitUntilCycle();
+    const resolve9 = this._consumeWaitUntilCycle();
     try {
       await super.flush();
     } catch {
     } finally {
-      resolve8?.();
+      resolve9?.();
     }
   }
   getPersistedProperty(key) {
@@ -5902,15 +5940,15 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
   async waitForLocalEvaluationReady(timeoutMs = THIRTY_SECONDS) {
     if (this.isLocalEvaluationReady()) return true;
     if (void 0 === this.featureFlagsPoller) return false;
-    return new Promise((resolve8) => {
+    return new Promise((resolve9) => {
       const timeout = setTimeout(() => {
         cleanup();
-        resolve8(false);
+        resolve9(false);
       }, timeoutMs);
       const cleanup = this._events.on("localEvaluationFlagsLoaded", (count) => {
         clearTimeout(timeout);
         cleanup();
-        resolve8(count > 0);
+        resolve9(count > 0);
       });
     });
   }
@@ -6365,14 +6403,14 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
     this.context?.enter(data, options);
   }
   async _shutdown(shutdownTimeoutMs) {
-    const resolve8 = this._consumeWaitUntilCycle();
+    const resolve9 = this._consumeWaitUntilCycle();
     await this.featureFlagsPoller?.stopPoller(shutdownTimeoutMs);
     this.errorTracking.shutdown();
     try {
       return await super._shutdown(shutdownTimeoutMs);
     } finally {
       this.distinctIdHasSentFlagCalls = {};
-      resolve8?.();
+      resolve9?.();
     }
   }
   async _requestRemoteConfigPayload(flagKey) {
@@ -8106,12 +8144,12 @@ function resolveHostFingerprint() {
   }
 }
 function resolveHostFingerprintAsync() {
-  return new Promise((resolve8) => {
+  return new Promise((resolve9) => {
     let binary;
     try {
       binary = simulatorServerBinaryPath();
     } catch {
-      resolve8(null);
+      resolve9(null);
       return;
     }
     let settled = false;
@@ -8124,7 +8162,7 @@ function resolveHostFingerprintAsync() {
         child?.kill("SIGKILL");
       } catch {
       }
-      resolve8(value);
+      resolve9(value);
     };
     const watchdog = setTimeout(() => finish(null), FINGERPRINT_TIMEOUT_MS);
     watchdog.unref?.();
@@ -8366,7 +8404,7 @@ async function shutdown(timeoutMs = SHORT_FLUSH_TIMEOUT_MS) {
   try {
     await Promise.race([
       client2.shutdown(timeoutMs),
-      new Promise((resolve8) => setTimeout(resolve8, timeoutMs + 250).unref())
+      new Promise((resolve9) => setTimeout(resolve9, timeoutMs + 250).unref())
     ]);
   } catch (err) {
     emitDebugError("shutdown failed", err);
@@ -8386,7 +8424,7 @@ async function markDisabled() {
       try {
         await Promise.race([
           client2.shutdown(SHORT_FLUSH_TIMEOUT_MS),
-          new Promise((resolve8) => setTimeout(resolve8, SHORT_FLUSH_TIMEOUT_MS).unref())
+          new Promise((resolve9) => setTimeout(resolve9, SHORT_FLUSH_TIMEOUT_MS).unref())
         ]);
       } catch {
       }
@@ -8628,13 +8666,13 @@ function splitOptions(argv) {
   return { json, outPath, argvForFlags: rest };
 }
 async function readStdin() {
-  return new Promise((resolve8, reject) => {
+  return new Promise((resolve9, reject) => {
     let data = "";
     process.stdin.setEncoding("utf8");
     process.stdin.on("data", (chunk) => {
       data += chunk;
     });
-    process.stdin.on("end", () => resolve8(data));
+    process.stdin.on("end", () => resolve9(data));
     process.stdin.on("error", reject);
   });
 }
@@ -8996,7 +9034,7 @@ function resolveArtifactDisplayPaths(report) {
 }
 function exitAfterFlush(code, streams = [process.stdout, process.stderr]) {
   return Promise.all(
-    streams.map((s) => new Promise((resolve8) => s.write("", () => resolve8())))
+    streams.map((s) => new Promise((resolve9) => s.write("", () => resolve9())))
   ).then(() => process.exit(code));
 }
 function renderReport(report) {
@@ -9881,7 +9919,7 @@ function ptyInjectBeats(text2) {
   ];
 }
 function sleep(ms) {
-  return new Promise((resolve8) => setTimeout(resolve8, ms));
+  return new Promise((resolve9) => setTimeout(resolve9, ms));
 }
 var DEFAULT_COLS = 80;
 var DEFAULT_ROWS = 24;
@@ -10102,7 +10140,7 @@ var SPAWN_GRACE_MS = 8e3;
 var DEATH_CONFIRMATIONS = 3;
 var SSE_RECONNECT_MS = 1e3;
 function sleep2(ms) {
-  return new Promise((resolve8) => setTimeout(resolve8, ms));
+  return new Promise((resolve9) => setTimeout(resolve9, ms));
 }
 var TRUST_PROMPT_RE = /trust this folder|do you trust|yes,? i trust|trust the files in this/i;
 async function dismissTrustPrompt(session) {

package/dist/installer.mjs

@@ -9593,13 +9593,13 @@ var require_min_release_age = __commonJS({
       return Number.isFinite(days) && days > 0 ? days * config_parse_1.DAY_MS : 0;
     }
     function probe(p) {
-      return new Promise((resolve11) => {
+      return new Promise((resolve12) => {
         (0, node_child_process_1.exec)(p.command, { timeout: PROBE_TIMEOUT_MS2, windowsHide: true }, (err, stdout2) => {
           if (err) {
-            resolve11(0);
+            resolve12(0);
             return;
           }
-          resolve11(p.parse(stdout2));
+          resolve12(p.parse(stdout2));
         });
       });
     }
@@ -9632,12 +9632,12 @@ var require_registry = __commonJS({
     var node_https_1 = __importDefault(__require("node:https"));
     var REQUEST_TIMEOUT_MS = 1e4;
     function fetchRegistryInfo2(url) {
-      return new Promise((resolve11) => {
+      return new Promise((resolve12) => {
         let resolved = false;
         const safeResolve = (value) => {
           if (!resolved) {
             resolved = true;
-            resolve11(value);
+            resolve12(value);
           }
         };
         const req = node_https_1.default.get(url, { timeout: REQUEST_TIMEOUT_MS }, (res) => {
@@ -13702,14 +13702,14 @@ async function addSourceContext(frames) {
   return frames;
 }
 function getContextLinesFromFile(path20, ranges, output) {
-  return new Promise((resolve11) => {
+  return new Promise((resolve12) => {
     const stream = createReadStream(path20);
     const lineReaded = createInterface2({
       input: stream
     });
     function destroyStreamAndResolve() {
       stream.destroy();
-      resolve11();
+      resolve12();
     }
     let lineNumber = 0;
     let currentRangeIndex = 0;
@@ -15006,9 +15006,9 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
     if (!waitUntil) return;
     if (this.disabled || this.optedOut) return;
     if (!this._waitUntilCycle) {
-      let resolve11;
+      let resolve12;
       const promise = new Promise((r2) => {
-        resolve11 = r2;
+        resolve12 = r2;
       });
       try {
         waitUntil(promise);
@@ -15016,7 +15016,7 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
         return;
       }
       this._waitUntilCycle = {
-        resolve: resolve11,
+        resolve: resolve12,
         startedAt: Date.now(),
         timer: void 0
       };
@@ -15040,12 +15040,12 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
     return cycle?.resolve;
   }
   async resolveWaitUntilFlush() {
-    const resolve11 = this._consumeWaitUntilCycle();
+    const resolve12 = this._consumeWaitUntilCycle();
     try {
       await super.flush();
     } catch {
     } finally {
-      resolve11?.();
+      resolve12?.();
     }
   }
   getPersistedProperty(key) {
@@ -15166,15 +15166,15 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
   async waitForLocalEvaluationReady(timeoutMs = THIRTY_SECONDS) {
     if (this.isLocalEvaluationReady()) return true;
     if (void 0 === this.featureFlagsPoller) return false;
-    return new Promise((resolve11) => {
+    return new Promise((resolve12) => {
       const timeout = setTimeout(() => {
         cleanup();
-        resolve11(false);
+        resolve12(false);
       }, timeoutMs);
       const cleanup = this._events.on("localEvaluationFlagsLoaded", (count) => {
         clearTimeout(timeout);
         cleanup();
-        resolve11(count > 0);
+        resolve12(count > 0);
       });
     });
   }
@@ -15629,14 +15629,14 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
     this.context?.enter(data, options);
   }
   async _shutdown(shutdownTimeoutMs) {
-    const resolve11 = this._consumeWaitUntilCycle();
+    const resolve12 = this._consumeWaitUntilCycle();
     await this.featureFlagsPoller?.stopPoller(shutdownTimeoutMs);
     this.errorTracking.shutdown();
     try {
       return await super._shutdown(shutdownTimeoutMs);
     } finally {
       this.distinctIdHasSentFlagCalls = {};
-      resolve11?.();
+      resolve12?.();
     }
   }
   async _requestRemoteConfigPayload(flagKey) {
@@ -17524,12 +17524,12 @@ function resolveHostFingerprint() {
   }
 }
 function resolveHostFingerprintAsync() {
-  return new Promise((resolve11) => {
+  return new Promise((resolve12) => {
     let binary;
     try {
       binary = simulatorServerBinaryPath();
     } catch {
-      resolve11(null);
+      resolve12(null);
       return;
     }
     let settled = false;
@@ -17542,7 +17542,7 @@ function resolveHostFingerprintAsync() {
         child?.kill("SIGKILL");
       } catch {
       }
-      resolve11(value);
+      resolve12(value);
     };
     const watchdog = setTimeout(() => finish(null), FINGERPRINT_TIMEOUT_MS);
     watchdog.unref?.();
@@ -17840,7 +17840,7 @@ async function shutdown(timeoutMs = SHORT_FLUSH_TIMEOUT_MS) {
   try {
     await Promise.race([
       client2.shutdown(timeoutMs),
-      new Promise((resolve11) => setTimeout(resolve11, timeoutMs + 250).unref())
+      new Promise((resolve12) => setTimeout(resolve12, timeoutMs + 250).unref())
     ]);
   } catch (err) {
     emitDebugError("shutdown failed", err);
@@ -20678,12 +20678,12 @@ async function isOnline(timeoutMs = PROBE_TIMEOUT_MS) {
   } catch {
     return false;
   }
-  return new Promise((resolve11) => {
-    const timer = setTimeout(() => resolve11(false), timeoutMs);
+  return new Promise((resolve12) => {
+    const timer = setTimeout(() => resolve12(false), timeoutMs);
     timer.unref();
     dns.lookup(host, (err) => {
       clearTimeout(timer);
-      resolve11(!err);
+      resolve12(!err);
     });
   });
 }
@@ -22303,7 +22303,7 @@ var ShellCommandError = class extends Error {
   signal;
 };
 function runShellCommand(cmd, opts = {}) {
-  return new Promise((resolve11, reject) => {
+  return new Promise((resolve12, reject) => {
     const child = spawn2(cmd.bin, cmd.args, {
       stdio: ["ignore", "pipe", "pipe"],
       shell: process.platform === "win32",
@@ -22314,7 +22314,7 @@ function runShellCommand(cmd, opts = {}) {
       stderr += chunk.toString();
     });
     child.on("close", (code, signal) => {
-      if (code === 0) resolve11();
+      if (code === 0) resolve12();
       else
         reject(
           new ShellCommandError(
@@ -23189,7 +23189,7 @@ async function runSkillsStep(args) {
   return skillsMethod;
 }
 function runNpxSkills(args, interactive, cwd) {
-  return new Promise((resolve11, reject) => {
+  return new Promise((resolve12, reject) => {
     const npxCmd = process.platform === "win32" ? "npx.cmd" : "npx";
     const child = spawn3(npxCmd, args, {
       stdio: interactive ? "inherit" : ["ignore", "pipe", "pipe"],
@@ -23208,7 +23208,7 @@ function runNpxSkills(args, interactive, cwd) {
     }
     child.on("close", (code) => {
       if (code === 0) {
-        resolve11();
+        resolve12();
       } else {
         const output = [stderr, stdout2].filter(Boolean).join("\n").trim();
         reject(new Error(output || `npx skills exited with code ${code}`));
@@ -23685,9 +23685,10 @@ var MAX_CONTENT_BYTES = 32 * 1024 * 1024;
 import { copyFile, mkdir as mkdir4, readFile as readFile4, realpath, rm as rm3, stat as stat3, writeFile as writeFile4 } from "node:fs/promises";
 import { constants as fsConstants } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import { basename as basename4, dirname as dirname13, extname as extname2, isAbsolute as isAbsolute5, join as join19, normalize, sep as sep6 } from "node:path";
+import { basename as basename4, dirname as dirname13, extname as extname2, isAbsolute as isAbsolute5, join as join19, normalize, resolve as resolve10, sep as sep6 } from "node:path";
 import { createHash as createHash4 } from "node:crypto";
 var ALLOWED_SAVE_DIRS = /* @__PURE__ */ new Set([normalize(".argent/recordings")]);
+var RECORDINGS_SAVE_DIR = normalize(".argent/recordings");
 var MAX_DURABLE_BYTES = 2 * 1024 * 1024 * 1024;
 
 // ../argent-installer/src/update.ts

package/dist/mcp-server.mjs

@@ -2984,7 +2984,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve6.call(this, root, ref);
+      let _sch = resolve7.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
         const { schemaId } = this.opts;
@@ -3011,7 +3011,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve6(root, ref) {
+    function resolve7(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -3642,7 +3642,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve6(baseURI, relativeURI, options) {
+    function resolve7(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse3(baseURI, schemelessOptions), parse3(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -3900,7 +3900,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize2,
-      resolve: resolve6,
+      resolve: resolve7,
       resolveComponent,
       equal,
       serialize,
@@ -13701,12 +13701,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve6) => {
+    return new Promise((resolve7) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve6();
+        resolve7();
       } else {
-        this._stdout.once("drain", resolve6);
+        this._stdout.once("drain", resolve7);
       }
     });
   }
@@ -14304,7 +14304,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve6) => setTimeout(resolve6, pollInterval));
+        await new Promise((resolve7) => setTimeout(resolve7, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error2) {
@@ -14321,7 +14321,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve6, reject) => {
+    return new Promise((resolve7, reject) => {
       const earlyReject = (error2) => {
         reject(error2);
       };
@@ -14399,7 +14399,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve6(parseResult.data);
+            resolve7(parseResult.data);
           }
         } catch (error2) {
           reject(error2);
@@ -14660,12 +14660,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve6, reject) => {
+    return new Promise((resolve7, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve6, interval);
+      const timeoutId = setTimeout(resolve7, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -15490,7 +15490,7 @@ function generateToken() {
   return randomBytes(AUTH_TOKEN_BYTES).toString("hex");
 }
 function findFreePort() {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     const srv = net.createServer();
     srv.listen(0, "127.0.0.1", () => {
       const addr = srv.address();
@@ -15501,7 +15501,7 @@ function findFreePort() {
       const port = addr.port;
       srv.close((err) => {
         if (err) reject(err);
-        else resolve6(port);
+        else resolve7(port);
       });
     });
     srv.on("error", reject);
@@ -15599,7 +15599,7 @@ function killSpawnedChild(child, pid) {
   }
 }
 function spawnToolsServer(paths, port, options = {}) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     let logFd;
     try {
       fs.mkdirSync(STATE_DIR, { recursive: true });
@@ -15636,7 +15636,7 @@ function spawnToolsServer(paths, port, options = {}) {
         rl.close();
         child.stdout?.resume();
         child.stdout?.unref?.();
-        settle(() => resolve6({ port: actualPort, pid }));
+        settle(() => resolve7({ port: actualPort, pid }));
       }
     });
     child.on("error", (err) => {
@@ -16085,9 +16085,9 @@ async function tarball(sourcePath) {
   return tarPath;
 }
 function sha256File(filePath) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     const hash = createHash2("sha256");
-    createReadStream(filePath).on("data", (chunk) => hash.update(chunk)).on("end", () => resolve6(hash.digest("hex"))).on("error", reject);
+    createReadStream(filePath).on("data", (chunk) => hash.update(chunk)).on("end", () => resolve7(hash.digest("hex"))).on("error", reject);
   });
 }
 async function uploadTar(tarPath, endpoint) {
@@ -16206,7 +16206,7 @@ async function applyClientFileDirectives(result) {
 import { copyFile, mkdir as mkdir4, readFile as readFile4, realpath, rm as rm3, stat as stat2, writeFile as writeFile4 } from "node:fs/promises";
 import { constants as fsConstants } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import { basename as basename3, dirname as dirname5, extname, isAbsolute as isAbsolute3, join as join8, normalize, sep as sep2 } from "node:path";
+import { basename as basename3, dirname as dirname5, extname, isAbsolute as isAbsolute3, join as join8, normalize, resolve as resolve5, sep as sep2 } from "node:path";
 import { createHash as createHash3 } from "node:crypto";
 
 // ../configuration-core/src/flags.ts
@@ -16310,6 +16310,31 @@ function readConfigObject(scope = "global", options = {}) {
   }
   return {};
 }
+var FORBIDDEN_SEGMENTS = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
+function splitKey(dottedKey) {
+  const parts = dottedKey.split(".");
+  if (parts.length === 0 || parts.some((p) => p === "")) {
+    throw new Error(`Invalid config key "${dottedKey}": empty path segment`);
+  }
+  for (const p of parts) {
+    if (FORBIDDEN_SEGMENTS.has(p)) {
+      throw new Error(`Invalid config key "${dottedKey}": forbidden segment "${p}"`);
+    }
+  }
+  return parts;
+}
+function isPlainObject3(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function getAtPath(obj, dottedKey) {
+  const parts = splitKey(dottedKey);
+  let cur = obj;
+  for (const part of parts) {
+    if (!isPlainObject3(cur)) return void 0;
+    cur = cur[part];
+  }
+  return cur;
+}
 var LOCK_STALE_MS2 = 1e4;
 var LOCK_MAX_WAIT_MS = 2e3;
 var LOCK_RETRY_MS = 25;
@@ -16382,8 +16407,162 @@ function updateConfig(mutate, scope = "global", options = {}) {
   }
 }
 
+// ../configuration-core/src/merge.ts
+function mergeRestrictive(local, global2) {
+  if (local === void 0) return global2;
+  if (global2 === void 0) return local;
+  if (typeof local === "boolean" && typeof global2 === "boolean") {
+    return local && global2;
+  }
+  if (typeof local === "number" && typeof global2 === "number") {
+    return Math.min(local, global2);
+  }
+  return local;
+}
+function toArray(value) {
+  return Array.isArray(value) ? value : null;
+}
+function mergeUnion(local, global2) {
+  const l = toArray(local);
+  const g = toArray(global2);
+  if (l === null && g === null) return local ?? global2;
+  const merged = [...g ?? [], ...l ?? []];
+  return Array.from(new Set(merged));
+}
+function mergeIntersection(local, global2) {
+  const l = toArray(local);
+  const g = toArray(global2);
+  if (l === null && g === null) return local ?? global2;
+  if (l === null) return global2;
+  if (g === null) return local;
+  const globalSet = new Set(g);
+  return l.filter((item) => globalSet.has(item));
+}
+function applyMergePolicy(policy, local, global2) {
+  if (typeof policy === "function") return policy({ local, global: global2 });
+  switch (policy) {
+    case "prioritize-local":
+      return local ?? global2;
+    case "prioritize-global":
+      return global2 ?? local;
+    case "prioritize-restrictive":
+      return mergeRestrictive(local, global2);
+    case "union":
+      return mergeUnion(local, global2);
+    case "intersection":
+      return mergeIntersection(local, global2);
+    default: {
+      const _exhaustive = policy;
+      return _exhaustive;
+    }
+  }
+}
+
+// ../configuration-core/src/config-schema.ts
+function asBoolean(raw) {
+  return typeof raw === "boolean" ? raw : void 0;
+}
+function asString(raw) {
+  if (typeof raw !== "string") return void 0;
+  const trimmed = raw.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function asStringArray(raw) {
+  if (!Array.isArray(raw)) return void 0;
+  const out = [];
+  for (const item of raw) {
+    if (typeof item === "string" && item.trim() !== "") out.push(item.trim());
+  }
+  return out;
+}
+var CONFIG_SCHEMA = [
+  {
+    key: "telemetry.enabled",
+    description: "Whether anonymous opt-out telemetry is enabled (on by default; environment opt-outs like DO_NOT_TRACK are not reflected here \u2014 `argent telemetry status` shows effective consent).",
+    scopes: ["global"],
+    parse: asBoolean,
+    // A committed project file must never re-enable telemetry a user disabled
+    // globally, so the more-restrictive (opt-out) value always wins.
+    merge: "prioritize-restrictive",
+    // Telemetry is opt-out: with nothing stored, consent.ts treats it as
+    // enabled, and the config surface must report the same instead of "(unset)".
+    default: true,
+    // Read-only under `argent config`: opt-in/out goes through the dedicated
+    // command so the live client is drained/reset, not just the file rewritten.
+    manageCommand: "argent telemetry"
+  },
+  {
+    key: "lens.agent",
+    description: "Coding-agent id remembered by `argent lens` to skip the picker.",
+    scopes: ["project", "global"],
+    parse: asString,
+    // A repo can pin the agent its screenshots should use; falls back to the
+    // user's global remembered choice.
+    merge: "prioritize-local",
+    example: "claude"
+  },
+  {
+    key: "ios.additionalDeviceSets",
+    description: "Additional CoreSimulator device-set directories whose simulators argent should see alongside the default set. Absolute paths (or ~/\u2026); relative entries resolve against the project root (project scope) or home (global scope).",
+    scopes: ["project", "global"],
+    parse: asStringArray,
+    // Additive: the scopes extend each other rather than shadow — a repo's
+    // committed device sets are appended to the user's global ones (global
+    // baseline first, project extras after, deduplicated). Note that
+    // `getAdditionalIosDeviceSets` re-implements this union (path resolution
+    // must precede dedup) and guards on the preset staying "union".
+    merge: "union",
+    example: '["~/DeviceSets/ci"]'
+  },
+  {
+    key: "recordings.directory",
+    description: "Directory where finished screen recordings (mp4) are saved on the client host. Absolute, `~`-prefixed, or relative to the project root (home dir when not in a project). Unset \u21D2 `.argent/recordings` under the project root.",
+    scopes: ["project", "global"],
+    parse: asString,
+    // A repo can pin where its recordings land; falls back to the user's global
+    // preference. Resolution happens on the client (the machine the mp4 is
+    // persisted to), so with a remote `argent link` tool-server it is the
+    // *client's* config that decides.
+    merge: "prioritize-local",
+    example: "~/Movies/argent"
+  }
+];
+function getConfigDefinition(key, registry2 = CONFIG_SCHEMA) {
+  return registry2.find((def) => def.key === key);
+}
+
 // ../configuration-core/src/config-access.ts
 import * as path7 from "node:path";
+function readScopeValue(def, scope, options) {
+  if (!def.scopes.includes(scope)) return void 0;
+  const raw = getAtPath(readConfigObject(scope, options), def.key);
+  return raw === void 0 ? void 0 : def.parse(raw);
+}
+function getConfigValue(def, options = {}) {
+  const local = readScopeValue(def, "project", options);
+  const global2 = readScopeValue(def, "global", options);
+  const merged = applyMergePolicy(def.merge, local, global2);
+  return merged ?? def.default;
+}
+function getConfigValueByKey(key, options = {}, registry2 = CONFIG_SCHEMA) {
+  const def = requireDefinition(key, registry2);
+  return getConfigValue(def, options);
+}
+function requireDefinition(key, registry2 = CONFIG_SCHEMA) {
+  const def = getConfigDefinition(key, registry2);
+  if (!def) {
+    throw new UnknownConfigKeyError(key);
+  }
+  return def;
+}
+var UnknownConfigKeyError = class extends Error {
+  constructor(key) {
+    super(`Unknown configuration key "${key}".`);
+    this.key = key;
+    this.name = "UnknownConfigKeyError";
+  }
+  key;
+};
 
 // ../argent-tools-client/src/artifacts.ts
 var ARTIFACT_MARKER = "__argentArtifact";
@@ -16420,6 +16599,21 @@ function durableBaseDir() {
   return projectRoot ?? dirname5(argentHomeDir());
 }
 var ALLOWED_SAVE_DIRS = /* @__PURE__ */ new Set([normalize(".argent/recordings")]);
+var RECORDINGS_SAVE_DIR = normalize(".argent/recordings");
+function configuredRecordingsDir() {
+  let value;
+  try {
+    value = getConfigValueByKey("recordings.directory");
+  } catch {
+    return null;
+  }
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  if (trimmed === "") return null;
+  const home = dirname5(argentHomeDir());
+  const expanded = trimmed === "~" ? home : trimmed.startsWith("~/") || trimmed.startsWith(`~${sep2}`) ? join8(home, trimmed.slice(2)) : trimmed;
+  return resolve5(durableBaseDir(), expanded);
+}
 var MAX_DURABLE_BYTES = 2 * 1024 * 1024 * 1024;
 async function readCapped(res, cap) {
   const headers = res.headers;
@@ -16469,6 +16663,17 @@ function durableSaveTarget(handle) {
     return null;
   }
   if (!ALLOWED_SAVE_DIRS.has(rel)) return null;
+  if (rel === RECORDINGS_SAVE_DIR) {
+    const configured = configuredRecordingsDir();
+    if (configured) {
+      return {
+        dir: configured,
+        path: join8(configured, sanitizeSegment(handle.filename)),
+        base: configured,
+        rel: ""
+      };
+    }
+  }
   const base = durableBaseDir();
   const dir = join8(base, rel);
   return { dir, path: join8(dir, sanitizeSegment(handle.filename)), base, rel };

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.18.1-next.0",
+  "version": "0.18.1-next.2",
+  "mcpName": "io.github.software-mansion/argent",
   "description": "MCP server for iOS Simulator and Android Emulator control",
   "license": "Apache-2.0",
   "repository": {

package/skills/argent-screen-recording/SKILL.md

@@ -30,7 +30,7 @@ A recording does not stop itself before its `timeLimitSeconds` cap, so a forgott
 5. Call `screen-recording-stop` with the same `udid`. It returns `{ video, durationMs, wallClockMs?, trimmedMs?, warning? }`; `video` is an artifact whose resolved path points at the durably-saved file (see below). The video is already final when stop returns (the watermark is stamped during capture, not in a second pass), so stop takes well under a second.
 6. Check `warning`: it reports cap-triggered stops, early encoder exits, a dropped frame stream, and possibly-truncated containers. Verify the file plays (or at least has a sane size) before presenting it to the user.
 
-**Where the file lands (durable, not scratch).** Unlike most argent artifacts (which live in a disposable temp cache the OS reclaims), a finished recording is saved durably on the **client** into `<project>/.argent/recordings/` — the project being the nearest ancestor of the client's working directory with a `.git`/`package.json`/`.argent`, or `~/.argent/recordings/` when the client isn't inside a project. This holds even for a remote `argent link` tool-server: the mp4 is written on the client host, not the server. The saved name is `screen-recording-<device>-<timestamp>.mp4`; if that name is already taken the new file lands beside it as `… (2).mp4` rather than overwriting. Because these files persist in the working tree, mention the path to the user (and note that they are untracked — add them to `.gitignore` or clean them up if they shouldn't be committed).
+**Where the file lands (durable, not scratch).** Unlike most argent artifacts (which live in a disposable temp cache the OS reclaims), a finished recording is saved durably on the **client** into `<project>/.argent/recordings/` — the project being the nearest ancestor of the client's working directory with a `.git`/`package.json`/`.argent`, or `~/.argent/recordings/` when the client isn't inside a project. This holds even for a remote `argent link` tool-server: the mp4 is written on the client host, not the server. The destination can be changed with the `recordings.directory` configuration (`argent config set recordings.directory <dir>`, global by default, `--scope project` for a per-repo choice; project wins when both are set) — the value may be absolute, `~`-prefixed, or relative to the project root, and is always resolved on the client host. The saved name is `screen-recording-<device>-<timestamp>.mp4`; if that name is already taken the new file lands beside it as `… (2).mp4` rather than overwriting. Because these files persist in the working tree, mention the path to the user (and note that they are untracked — add them to `.gitignore` or clean them up if they shouldn't be committed).
 
 **Static-frame trimming (on by default).** Stretches where the screen does not change are collapsed: the first second of each still stretch is kept so pauses read naturally, then unchanged frames are dropped until something moves again (a change of even a couple of pixels counts). So you can leave a recording running across slow steps, waits, or thinking time without padding the clip with dead air — a 40-second session with 5 seconds of real activity comes back as a ~5-7 second video. When trimming removed anything, stop also returns `wallClockMs` (real elapsed time) and `trimmedMs` (how much was cut); `durationMs` is always the length of the video you actually get. Pass `trimStatic: false` to `screen-recording-start` when you want a faithful real-time recording (e.g. to measure how long something took on screen).