@swmansion/argent 0.10.0 → 0.11.0

package/dist/cli-cmds.mjs

@@ -25,62 +25,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// ../../node_modules/sisteransi/src/index.js
-var require_src = __commonJS({
-  "../../node_modules/sisteransi/src/index.js"(exports, module) {
-    "use strict";
-    var ESC2 = "\x1B";
-    var CSI2 = `${ESC2}[`;
-    var beep = "\x07";
-    var cursor = {
-      to(x3, y) {
-        if (!y) return `${CSI2}${x3 + 1}G`;
-        return `${CSI2}${y + 1};${x3 + 1}H`;
-      },
-      move(x3, y) {
-        let ret = "";
-        if (x3 < 0) ret += `${CSI2}${-x3}D`;
-        else if (x3 > 0) ret += `${CSI2}${x3}C`;
-        if (y < 0) ret += `${CSI2}${-y}A`;
-        else if (y > 0) ret += `${CSI2}${y}B`;
-        return ret;
-      },
-      up: (count = 1) => `${CSI2}${count}A`,
-      down: (count = 1) => `${CSI2}${count}B`,
-      forward: (count = 1) => `${CSI2}${count}C`,
-      backward: (count = 1) => `${CSI2}${count}D`,
-      nextLine: (count = 1) => `${CSI2}E`.repeat(count),
-      prevLine: (count = 1) => `${CSI2}F`.repeat(count),
-      left: `${CSI2}G`,
-      hide: `${CSI2}?25l`,
-      show: `${CSI2}?25h`,
-      save: `${ESC2}7`,
-      restore: `${ESC2}8`
-    };
-    var scroll = {
-      up: (count = 1) => `${CSI2}S`.repeat(count),
-      down: (count = 1) => `${CSI2}T`.repeat(count)
-    };
-    var erase = {
-      screen: `${CSI2}2J`,
-      up: (count = 1) => `${CSI2}1J`.repeat(count),
-      down: (count = 1) => `${CSI2}J`.repeat(count),
-      line: `${CSI2}2K`,
-      lineEnd: `${CSI2}K`,
-      lineStart: `${CSI2}1K`,
-      lines(count) {
-        let clear = "";
-        for (let i = 0; i < count; i++)
-          clear += this.line + (i < count - 1 ? cursor.up() : "");
-        if (count)
-          clear += cursor.left;
-        return clear;
-      }
-    };
-    module.exports = { cursor, scroll, erase, beep };
-  }
-});
-
 // ../../node_modules/picocolors/picocolors.js
 var require_picocolors = __commonJS({
   "../../node_modules/picocolors/picocolors.js"(exports, module) {
@@ -153,6 +97,62 @@ var require_picocolors = __commonJS({
   }
 });
 
+// ../../node_modules/sisteransi/src/index.js
+var require_src = __commonJS({
+  "../../node_modules/sisteransi/src/index.js"(exports, module) {
+    "use strict";
+    var ESC2 = "\x1B";
+    var CSI2 = `${ESC2}[`;
+    var beep = "\x07";
+    var cursor = {
+      to(x3, y) {
+        if (!y) return `${CSI2}${x3 + 1}G`;
+        return `${CSI2}${y + 1};${x3 + 1}H`;
+      },
+      move(x3, y) {
+        let ret = "";
+        if (x3 < 0) ret += `${CSI2}${-x3}D`;
+        else if (x3 > 0) ret += `${CSI2}${x3}C`;
+        if (y < 0) ret += `${CSI2}${-y}A`;
+        else if (y > 0) ret += `${CSI2}${y}B`;
+        return ret;
+      },
+      up: (count = 1) => `${CSI2}${count}A`,
+      down: (count = 1) => `${CSI2}${count}B`,
+      forward: (count = 1) => `${CSI2}${count}C`,
+      backward: (count = 1) => `${CSI2}${count}D`,
+      nextLine: (count = 1) => `${CSI2}E`.repeat(count),
+      prevLine: (count = 1) => `${CSI2}F`.repeat(count),
+      left: `${CSI2}G`,
+      hide: `${CSI2}?25l`,
+      show: `${CSI2}?25h`,
+      save: `${ESC2}7`,
+      restore: `${ESC2}8`
+    };
+    var scroll = {
+      up: (count = 1) => `${CSI2}S`.repeat(count),
+      down: (count = 1) => `${CSI2}T`.repeat(count)
+    };
+    var erase = {
+      screen: `${CSI2}2J`,
+      up: (count = 1) => `${CSI2}1J`.repeat(count),
+      down: (count = 1) => `${CSI2}J`.repeat(count),
+      line: `${CSI2}2K`,
+      lineEnd: `${CSI2}K`,
+      lineStart: `${CSI2}1K`,
+      lines(count) {
+        let clear = "";
+        for (let i = 0; i < count; i++)
+          clear += this.line + (i < count - 1 ? cursor.up() : "");
+        if (count)
+          clear += cursor.left;
+        return clear;
+      }
+    };
+    module.exports = { cursor, scroll, erase, beep };
+  }
+});
+
 // ../argent-cli/src/run.ts
 import * as fs2 from "node:fs";
 import * as path3 from "node:path";
@@ -566,6 +566,138 @@ function createToolsClient(options = {}) {
   return { fetchTools, fetchTool, callTool, baseUrl };
 }
 
+// ../argent-tools-client/src/artifacts.ts
+import { mkdir as mkdir3, readFile as readFile3, rm, stat, writeFile as writeFile3 } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { basename, join as join3 } from "node:path";
+import { createHash } from "node:crypto";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+var execFileAsync = promisify(execFile);
+var ARTIFACT_MARKER = "__argentArtifact";
+function isArtifactHandle(value) {
+  return !!value && typeof value === "object" && value[ARTIFACT_MARKER] === true && typeof value.id === "string" && typeof value.filename === "string";
+}
+var SESSION_ID = null;
+function sessionId() {
+  if (!SESSION_ID) {
+    const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[-:T]/g, (m2) => m2 === "T" ? "-" : "").slice(0, 15);
+    SESSION_ID = `${stamp}-${process.pid}`;
+  }
+  return SESSION_ID;
+}
+function sanitizeSegment(segment) {
+  return segment.replace(/[^A-Za-z0-9._-]/g, "_");
+}
+function projectSlug() {
+  const cwd = process.cwd();
+  const hash = createHash("sha1").update(cwd).digest("hex").slice(0, 6);
+  const name = sanitizeSegment(basename(cwd)) || "root";
+  return `${name}-${hash}`;
+}
+function artifactsRoot() {
+  return process.env.ARGENT_ARTIFACTS_DIR ?? join3(tmpdir(), "argent-artifacts");
+}
+function artifactDir(deviceId) {
+  const parts = [artifactsRoot(), projectSlug(), sessionId()];
+  if (deviceId) parts.push(sanitizeSegment(deviceId));
+  return join3(...parts);
+}
+async function resolveLocalFile(handle) {
+  if (!handle.hostPath) return null;
+  try {
+    const st2 = await stat(handle.hostPath);
+    if (handle.archive) {
+      return st2.isDirectory() ? handle.hostPath : null;
+    }
+    if (!st2.isFile()) return null;
+    if (st2.size !== handle.size) return null;
+    if (handle.mtimeMs != null && Math.round(st2.mtimeMs) !== Math.round(handle.mtimeMs)) {
+      return null;
+    }
+    return handle.hostPath;
+  } catch {
+    return null;
+  }
+}
+async function downloadAndExtractArchive(handle, data, dir) {
+  const tarball = join3(dir, `${sanitizeSegment(handle.filename)}.tar.gz`);
+  try {
+    await writeFile3(tarball, data);
+    await execFileAsync("tar", ["-xzf", tarball, "-C", dir]);
+    return join3(dir, handle.filename);
+  } catch {
+    return null;
+  } finally {
+    await rm(tarball, { force: true }).catch(() => {
+    });
+  }
+}
+async function materializeArtifacts(result, ctx) {
+  const images = [];
+  const fetchFn = ctx.fetchImpl ?? fetch;
+  const authHeaders3 = ctx.authToken ? { Authorization: `Bearer ${ctx.authToken}` } : {};
+  const dir = artifactDir(ctx.deviceId);
+  let dirReady = false;
+  async function ensureDir() {
+    if (!dirReady) {
+      await mkdir3(dir, { recursive: true });
+      dirReady = true;
+    }
+  }
+  async function walk(value) {
+    if (isArtifactHandle(value)) {
+      const localPath = await resolveLocalFile(value);
+      if (localPath) {
+        if (value.mimeType.startsWith("image/")) {
+          images.push({ localPath, data: await readFile3(localPath), mimeType: value.mimeType });
+        }
+        return localPath;
+      }
+      try {
+        const res = await fetchFn(`${ctx.toolsUrl}/artifacts/${value.id}`, {
+          headers: authHeaders3
+        });
+        if (!res.ok) return null;
+        const data = Buffer.from(await res.arrayBuffer());
+        await ensureDir();
+        if (value.archive === "tar.gz") {
+          return await downloadAndExtractArchive(value, data, dir);
+        }
+        if (value.size > 0 && data.length !== value.size) return null;
+        const downloadedPath = join3(dir, sanitizeSegment(value.filename));
+        await writeFile3(downloadedPath, data);
+        if (value.mimeType.startsWith("image/")) {
+          images.push({ localPath: downloadedPath, data, mimeType: value.mimeType });
+        }
+        return downloadedPath;
+      } catch {
+        return null;
+      }
+    }
+    if (Array.isArray(value)) {
+      return Promise.all(value.map(walk));
+    }
+    if (value && typeof value === "object") {
+      const out = {};
+      for (const [k2, v2] of Object.entries(value)) {
+        out[k2] = await walk(v2);
+      }
+      return out;
+    }
+    return value;
+  }
+  const rewritten = await walk(result);
+  return { result: rewritten, images };
+}
+function getDeviceIdFromArgs(args) {
+  if (!args || typeof args !== "object") return void 0;
+  const rec = args;
+  if (typeof rec.udid === "string") return rec.udid;
+  if (typeof rec.device_id === "string") return rec.device_id;
+  return void 0;
+}
+
 // ../argent-cli/src/flag-parser.ts
 var FlagParseException = class extends Error {
 };
@@ -801,17 +933,19 @@ async function fetchImageToFile(result, outPath) {
   fs2.mkdirSync(path3.dirname(path3.resolve(outPath)), { recursive: true });
   fs2.writeFileSync(outPath, buf);
 }
-function renderResult(result, outputHint, json) {
+function renderResult(result, outputHint, images, json) {
   if (json) return JSON.stringify(result, null, 2);
-  if (outputHint === "image" && result && typeof result === "object" && "path" in result && typeof result.path === "string") {
-    const r = result;
-    return `Saved screenshot: ${r.path}`;
+  if (outputHint === "image") {
+    if (images.length > 0) return `Saved screenshot: ${images[0].localPath}`;
+    if (result && typeof result === "object" && "path" in result && typeof result.path === "string") {
+      return `Saved screenshot: ${result.path}`;
+    }
   }
   if (typeof result === "string") return result;
   return JSON.stringify(result, null, 2);
 }
 async function run(argv, options) {
-  const { fetchTool, callTool } = createToolsClient({ paths: options.paths });
+  const { fetchTool, callTool, baseUrl } = createToolsClient({ paths: options.paths });
   const [toolName, ...rest] = argv;
   if (!toolName || toolName === "--help" || toolName === "-h") {
     console.log(`Usage: argent run <tool> [flags]
@@ -873,24 +1007,37 @@ Examples:
   }
   let result;
   let note;
+  let images = [];
   try {
     const resp = await callTool(toolName, payload);
-    result = resp.data;
+    const { url, token } = await baseUrl();
+    const materialized = await materializeArtifacts(resp.data, {
+      toolsUrl: url,
+      authToken: token,
+      deviceId: getDeviceIdFromArgs(payload)
+    });
+    result = materialized.result;
+    images = materialized.images;
     note = resp.note;
   } catch (err) {
     console.error(err instanceof Error ? err.message : String(err));
     process.exit(1);
   }
-  if (outPath && meta.outputHint === "image" && result && typeof result === "object") {
+  if (outPath && meta.outputHint === "image") {
     try {
-      await fetchImageToFile(result, outPath);
+      if (images.length > 0) {
+        fs2.mkdirSync(path3.dirname(path3.resolve(outPath)), { recursive: true });
+        fs2.writeFileSync(outPath, images[0].data);
+      } else if (result && typeof result === "object") {
+        await fetchImageToFile(result, outPath);
+      }
     } catch (err) {
       console.error(`Failed to save image: ${err instanceof Error ? err.message : err}`);
       process.exit(1);
     }
   }
   if (note) console.error(note);
-  console.log(renderResult(result, meta.outputHint, json));
+  console.log(renderResult(result, meta.outputHint, images, json));
   if (outPath && meta.outputHint === "image" && !json) {
     console.log(`Wrote: ${outPath}`);
   }
@@ -1375,99 +1522,395 @@ async function server(argv, options) {
   }
 }
 
-// ../../node_modules/@clack/core/dist/index.mjs
-import { styleText as v } from "node:util";
-import { stdout as x, stdin as D } from "node:process";
-import * as b from "node:readline";
-import E from "node:readline";
-
-// ../../node_modules/fast-string-truncated-width/dist/utils.js
-var getCodePointsLength = /* @__PURE__ */ (() => {
-  const SURROGATE_PAIR_RE = /[\uD800-\uDBFF][\uDC00-\uDFFF]/g;
-  return (input) => {
-    let surrogatePairsNr = 0;
-    SURROGATE_PAIR_RE.lastIndex = 0;
-    while (SURROGATE_PAIR_RE.test(input)) {
-      surrogatePairsNr += 1;
-    }
-    return input.length - surrogatePairsNr;
-  };
-})();
-var isFullWidth = (x3) => {
-  return x3 === 12288 || x3 >= 65281 && x3 <= 65376 || x3 >= 65504 && x3 <= 65510;
-};
-var isWideNotCJKTNotEmoji = (x3) => {
-  return x3 === 8987 || x3 === 9001 || x3 >= 12272 && x3 <= 12287 || x3 >= 12289 && x3 <= 12350 || x3 >= 12441 && x3 <= 12543 || x3 >= 12549 && x3 <= 12591 || x3 >= 12593 && x3 <= 12686 || x3 >= 12688 && x3 <= 12771 || x3 >= 12783 && x3 <= 12830 || x3 >= 12832 && x3 <= 12871 || x3 >= 12880 && x3 <= 19903 || x3 >= 65040 && x3 <= 65049 || x3 >= 65072 && x3 <= 65106 || x3 >= 65108 && x3 <= 65126 || x3 >= 65128 && x3 <= 65131 || x3 >= 127488 && x3 <= 127490 || x3 >= 127504 && x3 <= 127547 || x3 >= 127552 && x3 <= 127560 || x3 >= 131072 && x3 <= 196605 || x3 >= 196608 && x3 <= 262141;
-};
+// ../argent-cli/src/flags.ts
+var import_picocolors = __toESM(require_picocolors(), 1);
 
-// ../../node_modules/fast-string-truncated-width/dist/index.js
-var ANSI_RE = /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]|\u001b\]8;[^;]*;.*?(?:\u0007|\u001b\u005c)/y;
-var CONTROL_RE = /[\x00-\x08\x0A-\x1F\x7F-\x9F]{1,1000}/y;
-var CJKT_WIDE_RE = /(?:(?![\uFF61-\uFF9F\uFF00-\uFFEF])[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}\p{Script=Tangut}]){1,1000}/yu;
-var TAB_RE = /\t{1,1000}/y;
-var EMOJI_RE = new RegExp("[\\u{1F1E6}-\\u{1F1FF}]{2}|\\u{1F3F4}[\\u{E0061}-\\u{E007A}]{2}[\\u{E0030}-\\u{E0039}\\u{E0061}-\\u{E007A}]{1,3}\\u{E007F}|(?:\\p{Emoji}\\uFE0F\\u20E3?|\\p{Emoji_Modifier_Base}\\p{Emoji_Modifier}?|\\p{Emoji_Presentation})(?:\\u200D(?:\\p{Emoji_Modifier_Base}\\p{Emoji_Modifier}?|\\p{Emoji_Presentation}|\\p{Emoji}\\uFE0F\\u20E3?))*", "yu");
-var LATIN_RE = /(?:[\x20-\x7E\xA0-\xFF](?!\uFE0F)){1,1000}/y;
-var MODIFIER_RE = new RegExp("\\p{M}+", "gu");
-var NO_TRUNCATION = { limit: Infinity, ellipsis: "" };
-var getStringTruncatedWidth = (input, truncationOptions = {}, widthOptions = {}) => {
-  const LIMIT = truncationOptions.limit ?? Infinity;
-  const ELLIPSIS = truncationOptions.ellipsis ?? "";
-  const ELLIPSIS_WIDTH = truncationOptions?.ellipsisWidth ?? (ELLIPSIS ? getStringTruncatedWidth(ELLIPSIS, NO_TRUNCATION, widthOptions).width : 0);
-  const ANSI_WIDTH = 0;
-  const CONTROL_WIDTH = widthOptions.controlWidth ?? 0;
-  const TAB_WIDTH = widthOptions.tabWidth ?? 8;
-  const EMOJI_WIDTH = widthOptions.emojiWidth ?? 2;
-  const FULL_WIDTH_WIDTH = 2;
-  const REGULAR_WIDTH = widthOptions.regularWidth ?? 1;
-  const WIDE_WIDTH = widthOptions.wideWidth ?? FULL_WIDTH_WIDTH;
-  const PARSE_BLOCKS = [
-    [LATIN_RE, REGULAR_WIDTH],
-    [ANSI_RE, ANSI_WIDTH],
-    [CONTROL_RE, CONTROL_WIDTH],
-    [TAB_RE, TAB_WIDTH],
-    [EMOJI_RE, EMOJI_WIDTH],
-    [CJKT_WIDE_RE, WIDE_WIDTH]
-  ];
-  let indexPrev = 0;
-  let index = 0;
-  let length = input.length;
-  let lengthExtra = 0;
-  let truncationEnabled = false;
-  let truncationIndex = length;
-  let truncationLimit = Math.max(0, LIMIT - ELLIPSIS_WIDTH);
-  let unmatchedStart = 0;
-  let unmatchedEnd = 0;
-  let width = 0;
-  let widthExtra = 0;
-  outer: while (true) {
-    if (unmatchedEnd > unmatchedStart || index >= length && index > indexPrev) {
-      const unmatched = input.slice(unmatchedStart, unmatchedEnd) || input.slice(indexPrev, index);
-      lengthExtra = 0;
-      for (const char of unmatched.replaceAll(MODIFIER_RE, "")) {
-        const codePoint = char.codePointAt(0) || 0;
-        if (isFullWidth(codePoint)) {
-          widthExtra = FULL_WIDTH_WIDTH;
-        } else if (isWideNotCJKTNotEmoji(codePoint)) {
-          widthExtra = WIDE_WIDTH;
-        } else {
-          widthExtra = REGULAR_WIDTH;
-        }
-        if (width + widthExtra > truncationLimit) {
-          truncationIndex = Math.min(truncationIndex, Math.max(unmatchedStart, indexPrev) + lengthExtra);
-        }
-        if (width + widthExtra > LIMIT) {
-          truncationEnabled = true;
-          break outer;
-        }
-        lengthExtra += char.length;
-        width += widthExtra;
-      }
-      unmatchedStart = unmatchedEnd = 0;
-    }
-    if (index >= length) {
-      break outer;
+// ../configuration-core/src/flags.ts
+import * as fs4 from "node:fs";
+import * as path5 from "node:path";
+import { homedir as homedir4 } from "node:os";
+var FLAG_REGISTRY = [
+  {
+    name: "disable-auto-screenshot",
+    description: "Disable the automatic screenshot captured after interaction tools."
+  }
+];
+function getFlagDefinition(name, registry = FLAG_REGISTRY) {
+  return registry.find((def) => def.name === name);
+}
+var PROJECT_MARKERS = [".argent", ".git", "package.json"];
+function resolveProjectRoot(startDir) {
+  const initial = path5.resolve(startDir);
+  let current = initial;
+  while (true) {
+    for (const marker of PROJECT_MARKERS) {
+      if (fs4.existsSync(path5.join(current, marker))) return current;
     }
-    for (let i = 0, l = PARSE_BLOCKS.length; i < l; i++) {
+    const parent = path5.dirname(current);
+    if (parent === current) return initial;
+    current = parent;
+  }
+}
+function getFlagsPath(scope, options = {}) {
+  const home = options.homeDir ?? homedir4();
+  if (scope === "global") {
+    return path5.join(home, ".argent", "flags.json");
+  }
+  const cwd = options.cwd ?? process.cwd();
+  return path5.join(resolveProjectRoot(cwd), ".argent", "flags.json");
+}
+function readFlagsFile(filePath) {
+  let raw;
+  try {
+    raw = fs4.readFileSync(filePath, "utf8");
+  } catch {
+    return {};
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return {};
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+  const flags2 = parsed.flags;
+  if (!flags2 || typeof flags2 !== "object" || Array.isArray(flags2)) return {};
+  const out = {};
+  for (const [k2, v2] of Object.entries(flags2)) {
+    if (typeof v2 === "boolean") out[k2] = v2;
+  }
+  return out;
+}
+function writeFlagsFile(filePath, flags2) {
+  if (Object.keys(flags2).length === 0) {
+    if (fs4.existsSync(filePath)) fs4.rmSync(filePath, { force: true });
+    const parent = path5.dirname(filePath);
+    try {
+      if (fs4.existsSync(parent) && fs4.readdirSync(parent).length === 0) {
+        fs4.rmdirSync(parent);
+      }
+    } catch {
+    }
+    return;
+  }
+  fs4.mkdirSync(path5.dirname(filePath), { recursive: true });
+  const tmp = `${filePath}.${process.pid}.tmp`;
+  fs4.writeFileSync(tmp, JSON.stringify({ flags: flags2 }, null, 2) + "\n");
+  fs4.renameSync(tmp, filePath);
+}
+function readFlags(scope, options = {}) {
+  return readFlagsFile(getFlagsPath(scope, options));
+}
+function setFlag(name, value, scope, options = {}) {
+  const filePath = getFlagsPath(scope, options);
+  const current = readFlagsFile(filePath);
+  current[name] = value;
+  writeFlagsFile(filePath, current);
+}
+function unsetFlag(name, scope, options = {}) {
+  const filePath = getFlagsPath(scope, options);
+  const current = readFlagsFile(filePath);
+  if (!Object.hasOwn(current, name)) return false;
+  delete current[name];
+  writeFlagsFile(filePath, current);
+  return true;
+}
+function isFlagEnabled(name, options = {}) {
+  const projectFlags = readFlags("project", options);
+  if (Object.hasOwn(projectFlags, name)) return projectFlags[name];
+  const globalFlags = readFlags("global", options);
+  if (Object.hasOwn(globalFlags, name)) return globalFlags[name];
+  return false;
+}
+
+// ../argent-cli/src/flags.ts
+function colorState(enabled) {
+  const label = (enabled ? "enabled" : "disabled").padEnd(8);
+  if (!process.stdout.isTTY) return label;
+  return enabled ? import_picocolors.default.green(label) : import_picocolors.default.red(label);
+}
+var FLAG_NAME_RE = /^[a-zA-Z][a-zA-Z0-9._-]*$/;
+function parseToggleArgs(argv, command) {
+  let name = null;
+  let scope = "global";
+  let positionalOnly = false;
+  for (let i = 0; i < argv.length; i++) {
+    const tok = argv[i];
+    if (positionalOnly) {
+      if (name !== null) throw new Error(`Unexpected extra argument: "${tok}"`);
+      name = tok;
+      continue;
+    }
+    if (tok === "--") {
+      positionalOnly = true;
+      continue;
+    }
+    if (tok === "--scope") {
+      const v2 = argv[i + 1];
+      if (v2 === void 0) throw new Error("--scope requires a value (project|global)");
+      scope = parseScope(v2);
+      i += 1;
+      continue;
+    }
+    if (tok.startsWith("--scope=")) {
+      scope = parseScope(tok.slice("--scope=".length));
+      continue;
+    }
+    if (tok.startsWith("--")) {
+      throw new Error(`Unknown flag: ${tok}`);
+    }
+    if (name !== null) {
+      throw new Error(`Unexpected extra argument: "${tok}"`);
+    }
+    name = tok;
+  }
+  if (name === null) {
+    throw new Error(`Usage: argent ${command} <flag-name> [--scope project|global]`);
+  }
+  if (!FLAG_NAME_RE.test(name)) {
+    throw new Error(
+      `Invalid flag name "${name}". Must start with a letter and contain only letters, digits, ".", "_", or "-".`
+    );
+  }
+  return { name, scope };
+}
+function parseScope(raw) {
+  if (raw === "global" || raw === "project") return raw;
+  throw new Error(`--scope must be "project" or "global", got "${raw}"`);
+}
+function formatAvailableFlags(registry) {
+  if (registry.length === 0) {
+    return "Available flags:\n  (none defined)";
+  }
+  const maxName = registry.reduce((m2, def) => Math.max(m2, def.name.length), 0);
+  const lines = registry.map((def) => `  ${def.name.padEnd(maxName)}  ${def.description}`);
+  return ["Available flags:", ...lines].join("\n");
+}
+function printToggleHelp(command, registry) {
+  const summary = command === "enable" ? "Enable a predefined feature flag (see `argent flags`) at the chosen scope." : "Remove a feature flag entry at the chosen scope. Falls back to the global value if set; otherwise the flag is treated as off.";
+  console.log(`Usage: argent ${command} <flag-name> [--scope project|global]
+
+${summary}
+
+${formatAvailableFlags(registry)}
+
+Storage:
+  ~/.argent/flags.json                 (global, default)
+  <project-root>/.argent/flags.json    (project, with --scope project)
+
+Options:
+  --scope <global|project>   Where to write (default: global)
+  --help, -h                 Show this help
+`);
+}
+function runToggle(argv, command, registry) {
+  if (argv.includes("--help") || argv.includes("-h")) {
+    printToggleHelp(command, registry);
+    return;
+  }
+  let parsed;
+  try {
+    parsed = parseToggleArgs(argv, command);
+  } catch (err) {
+    console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(2);
+  }
+  if (command === "enable" && getFlagDefinition(parsed.name, registry) === void 0) {
+    console.error(
+      `Error: Unknown feature flag "${parsed.name}". Run \`argent flags\` to see available flags.`
+    );
+    process.exit(2);
+  }
+  const filePath = getFlagsPath(parsed.scope);
+  try {
+    if (command === "enable") {
+      setFlag(parsed.name, true, parsed.scope);
+    } else {
+      unsetFlag(parsed.name, parsed.scope);
+    }
+  } catch (err) {
+    console.error(`Failed to ${command} flag: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+  if (command === "enable") {
+    console.log(`Enabled flag "${parsed.name}" (${parsed.scope}). Stored at ${filePath}.`);
+  } else {
+    console.log(`Disabled flag "${parsed.name}" (${parsed.scope}).`);
+  }
+}
+function enable(argv, registry = FLAG_REGISTRY) {
+  runToggle(argv, "enable", registry);
+}
+function disable(argv, registry = FLAG_REGISTRY) {
+  runToggle(argv, "disable", registry);
+}
+function flags(argv, registry = FLAG_REGISTRY) {
+  if (argv.includes("--help") || argv.includes("-h")) {
+    console.log(`Usage: argent flags [--json]
+
+List the available feature flags and their current state. Flags are
+predefined; project-scoped values override global ones.
+
+${formatAvailableFlags(registry)}
+
+Options:
+  --json   Print machine-readable JSON
+`);
+    return;
+  }
+  const json = argv.includes("--json");
+  const projectFlags = readFlags("project");
+  const globalFlags = readFlags("global");
+  const effective = {};
+  for (const [k2, v2] of Object.entries(globalFlags)) effective[k2] = { value: v2, scope: "global" };
+  for (const [k2, v2] of Object.entries(projectFlags)) effective[k2] = { value: v2, scope: "project" };
+  const registryView = registry.map((def) => {
+    const eff = Object.hasOwn(effective, def.name) ? effective[def.name] : void 0;
+    return {
+      name: def.name,
+      description: def.description,
+      enabled: eff?.value ?? false,
+      scope: eff?.scope ?? null
+    };
+  });
+  const known = new Set(registry.map((def) => def.name));
+  const unrecognized = Object.keys(effective).filter((name) => !known.has(name)).sort().map((name) => ({ name, enabled: effective[name].value, scope: effective[name].scope }));
+  if (json) {
+    console.log(
+      JSON.stringify(
+        {
+          flags: registryView,
+          unrecognized,
+          global: globalFlags,
+          project: projectFlags,
+          effective,
+          paths: {
+            global: getFlagsPath("global"),
+            project: getFlagsPath("project")
+          }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  if (registryView.length === 0) {
+    console.log("No feature flags are defined.");
+  } else {
+    console.log("Feature flags (project overrides global):");
+    const maxName = registryView.reduce((m2, f2) => Math.max(m2, f2.name.length), 0);
+    for (const f2 of registryView) {
+      const scopeLabel = f2.scope ? ` (${f2.scope})` : "";
+      console.log(`  ${f2.name.padEnd(maxName, " ")}  ${colorState(f2.enabled)}${scopeLabel}`);
+      console.log(`  ${" ".repeat(maxName)}  ${f2.description}`);
+    }
+  }
+  if (unrecognized.length > 0) {
+    console.log("\nStored but no longer recognized (safe to `argent disable`):");
+    const maxName = unrecognized.reduce((m2, f2) => Math.max(m2, f2.name.length), 0);
+    for (const f2 of unrecognized) {
+      console.log(`  ${f2.name.padEnd(maxName, " ")}  ${colorState(f2.enabled)} (${f2.scope})`);
+    }
+  }
+  console.log(`
+  Global:  ${getFlagsPath("global")}`);
+  console.log(`  Project: ${getFlagsPath("project")}`);
+}
+
+// ../../node_modules/@clack/core/dist/index.mjs
+import { styleText as v } from "node:util";
+import { stdout as x, stdin as D } from "node:process";
+import * as b from "node:readline";
+import E from "node:readline";
+
+// ../../node_modules/fast-string-truncated-width/dist/utils.js
+var getCodePointsLength = /* @__PURE__ */ (() => {
+  const SURROGATE_PAIR_RE = /[\uD800-\uDBFF][\uDC00-\uDFFF]/g;
+  return (input) => {
+    let surrogatePairsNr = 0;
+    SURROGATE_PAIR_RE.lastIndex = 0;
+    while (SURROGATE_PAIR_RE.test(input)) {
+      surrogatePairsNr += 1;
+    }
+    return input.length - surrogatePairsNr;
+  };
+})();
+var isFullWidth = (x3) => {
+  return x3 === 12288 || x3 >= 65281 && x3 <= 65376 || x3 >= 65504 && x3 <= 65510;
+};
+var isWideNotCJKTNotEmoji = (x3) => {
+  return x3 === 8987 || x3 === 9001 || x3 >= 12272 && x3 <= 12287 || x3 >= 12289 && x3 <= 12350 || x3 >= 12441 && x3 <= 12543 || x3 >= 12549 && x3 <= 12591 || x3 >= 12593 && x3 <= 12686 || x3 >= 12688 && x3 <= 12771 || x3 >= 12783 && x3 <= 12830 || x3 >= 12832 && x3 <= 12871 || x3 >= 12880 && x3 <= 19903 || x3 >= 65040 && x3 <= 65049 || x3 >= 65072 && x3 <= 65106 || x3 >= 65108 && x3 <= 65126 || x3 >= 65128 && x3 <= 65131 || x3 >= 127488 && x3 <= 127490 || x3 >= 127504 && x3 <= 127547 || x3 >= 127552 && x3 <= 127560 || x3 >= 131072 && x3 <= 196605 || x3 >= 196608 && x3 <= 262141;
+};
+
+// ../../node_modules/fast-string-truncated-width/dist/index.js
+var ANSI_RE = /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]|\u001b\]8;[^;]*;.*?(?:\u0007|\u001b\u005c)/y;
+var CONTROL_RE = /[\x00-\x08\x0A-\x1F\x7F-\x9F]{1,1000}/y;
+var CJKT_WIDE_RE = /(?:(?![\uFF61-\uFF9F\uFF00-\uFFEF])[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}\p{Script=Tangut}]){1,1000}/yu;
+var TAB_RE = /\t{1,1000}/y;
+var EMOJI_RE = new RegExp("[\\u{1F1E6}-\\u{1F1FF}]{2}|\\u{1F3F4}[\\u{E0061}-\\u{E007A}]{2}[\\u{E0030}-\\u{E0039}\\u{E0061}-\\u{E007A}]{1,3}\\u{E007F}|(?:\\p{Emoji}\\uFE0F\\u20E3?|\\p{Emoji_Modifier_Base}\\p{Emoji_Modifier}?|\\p{Emoji_Presentation})(?:\\u200D(?:\\p{Emoji_Modifier_Base}\\p{Emoji_Modifier}?|\\p{Emoji_Presentation}|\\p{Emoji}\\uFE0F\\u20E3?))*", "yu");
+var LATIN_RE = /(?:[\x20-\x7E\xA0-\xFF](?!\uFE0F)){1,1000}/y;
+var MODIFIER_RE = new RegExp("\\p{M}+", "gu");
+var NO_TRUNCATION = { limit: Infinity, ellipsis: "" };
+var getStringTruncatedWidth = (input, truncationOptions = {}, widthOptions = {}) => {
+  const LIMIT = truncationOptions.limit ?? Infinity;
+  const ELLIPSIS = truncationOptions.ellipsis ?? "";
+  const ELLIPSIS_WIDTH = truncationOptions?.ellipsisWidth ?? (ELLIPSIS ? getStringTruncatedWidth(ELLIPSIS, NO_TRUNCATION, widthOptions).width : 0);
+  const ANSI_WIDTH = 0;
+  const CONTROL_WIDTH = widthOptions.controlWidth ?? 0;
+  const TAB_WIDTH = widthOptions.tabWidth ?? 8;
+  const EMOJI_WIDTH = widthOptions.emojiWidth ?? 2;
+  const FULL_WIDTH_WIDTH = 2;
+  const REGULAR_WIDTH = widthOptions.regularWidth ?? 1;
+  const WIDE_WIDTH = widthOptions.wideWidth ?? FULL_WIDTH_WIDTH;
+  const PARSE_BLOCKS = [
+    [LATIN_RE, REGULAR_WIDTH],
+    [ANSI_RE, ANSI_WIDTH],
+    [CONTROL_RE, CONTROL_WIDTH],
+    [TAB_RE, TAB_WIDTH],
+    [EMOJI_RE, EMOJI_WIDTH],
+    [CJKT_WIDE_RE, WIDE_WIDTH]
+  ];
+  let indexPrev = 0;
+  let index = 0;
+  let length = input.length;
+  let lengthExtra = 0;
+  let truncationEnabled = false;
+  let truncationIndex = length;
+  let truncationLimit = Math.max(0, LIMIT - ELLIPSIS_WIDTH);
+  let unmatchedStart = 0;
+  let unmatchedEnd = 0;
+  let width = 0;
+  let widthExtra = 0;
+  outer: while (true) {
+    if (unmatchedEnd > unmatchedStart || index >= length && index > indexPrev) {
+      const unmatched = input.slice(unmatchedStart, unmatchedEnd) || input.slice(indexPrev, index);
+      lengthExtra = 0;
+      for (const char of unmatched.replaceAll(MODIFIER_RE, "")) {
+        const codePoint = char.codePointAt(0) || 0;
+        if (isFullWidth(codePoint)) {
+          widthExtra = FULL_WIDTH_WIDTH;
+        } else if (isWideNotCJKTNotEmoji(codePoint)) {
+          widthExtra = WIDE_WIDTH;
+        } else {
+          widthExtra = REGULAR_WIDTH;
+        }
+        if (width + widthExtra > truncationLimit) {
+          truncationIndex = Math.min(truncationIndex, Math.max(unmatchedStart, indexPrev) + lengthExtra);
+        }
+        if (width + widthExtra > LIMIT) {
+          truncationEnabled = true;
+          break outer;
+        }
+        lengthExtra += char.length;
+        width += widthExtra;
+      }
+      unmatchedStart = unmatchedEnd = 0;
+    }
+    if (index >= length) {
+      break outer;
+    }
+    for (let i = 0, l = PARSE_BLOCKS.length; i < l; i++) {
       const [BLOCK_RE, BLOCK_WIDTH] = PARSE_BLOCKS[i];
       BLOCK_RE.lastIndex = index;
       if (BLOCK_RE.test(input)) {
@@ -2268,7 +2711,7 @@ ${c}
 } }).prompt();
 
 // ../argent-cli/src/link.ts
-var import_picocolors = __toESM(require_picocolors(), 1);
+var import_picocolors2 = __toESM(require_picocolors(), 1);
 var WILDCARD_HOSTS = /* @__PURE__ */ new Set(["0.0.0.0", "::", "::0", ""]);
 function isLoopback2(host) {
   return host === "127.0.0.1" || host === "localhost" || host === "::1";
@@ -2420,587 +2863,311 @@ Examples:
   argent link --host 10.0.0.42 --port 3001   Confirms interactively, then saves.
   argent link --host 10.0.0.42 --token ab12\u2026c2 --yes
                                              Non-interactive, authenticated.
-  argent link --host 10.0.0.42 --yes --no-verify
-                                             Saves immediately, no health check.
-
-Security:
-  The token (if any) is stored 0600 and sent as a bearer header. An http:// link
-  has no TLS \u2014 treat any non-loopback http link as trusted-network-only. Prefer
-  an https:// tunnel/proxy when crossing untrusted networks.
-
-Notes:
-  - If ARGENT_TOOLS_URL is also set in your environment, it overrides the link.
-  - To stop using the remote target, run \`argent unlink\`.
-  - \`argent server start/stop/status\` manage the local tool-server lifecycle
-    and are unaffected by linking.
-  - Restart your editor (Claude / Cursor / VS Code) afterwards \u2014 a running
-    \`argent mcp\` process caches the target at startup and won't pick up the
-    new link until it's relaunched.
-`);
-}
-function printUnlinkHelp() {
-  console.log(`Usage: argent unlink [flags]
-
-Remove the persisted remote tool-server link (~/.argent/link.json) and return
-to default local auto-spawn behaviour.
-
-Flags:
-  --yes, -y     Skip the confirmation prompt.
-  --help, -h    Show this help.
-
-Examples:
-  argent unlink         Confirms, then removes the link.
-  argent unlink --yes   Removes without confirmation. Safe in scripts.
-
-Notes:
-  - No-op (exit 0) if no link is currently set.
-  - If ARGENT_TOOLS_URL is also set in your environment, it still takes
-    precedence after unlinking \u2014 unset it manually for fully local behaviour.
-  - This does not stop or start any tool-server process. Use
-    \`argent server stop\` if you also want to terminate a running local server.
-  - Restart your editor afterwards \u2014 a running \`argent mcp\` process won't
-    revert to local auto-spawn until it's relaunched.
-`);
-}
-async function promptHost(existing, initial) {
-  const hostInput = await Pe({
-    message: "Remote host or IP to connect to",
-    placeholder: existing?.host ?? "127.0.0.1",
-    initialValue: initial ?? existing?.host,
-    validate(value) {
-      if (!value || !value.trim()) return "Host cannot be empty.";
-      const trimmed = value.trim();
-      if (WILDCARD_HOSTS.has(trimmed)) {
-        return `${trimmed} is a bind address, not a connect address \u2014 use 127.0.0.1 or the actual reachable host.`;
-      }
-    }
-  });
-  if (q(hostInput)) {
-    me("Link cancelled.");
-    process.exit(0);
-  }
-  return hostInput.trim();
-}
-async function promptPort(existing, initial) {
-  const defaultPort = initial ?? existing?.port ?? 3001;
-  const portInput = await Pe({
-    message: "Remote port",
-    placeholder: String(defaultPort),
-    initialValue: String(defaultPort),
-    validate(value) {
-      if (!value || !value.trim()) return "Port cannot be empty.";
-      try {
-        validateConnectPort(value.trim());
-      } catch (err) {
-        if (err instanceof StartFlagError) return err.message;
-        throw err;
-      }
-    }
-  });
-  if (q(portInput)) {
-    me("Link cancelled.");
-    process.exit(0);
-  }
-  return validateConnectPort(portInput.trim());
-}
-async function preflightHealth(url, token) {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), 3e3);
-  try {
-    const res = await fetch(`${url}/tools`, {
-      signal: controller.signal,
-      headers: token ? { Authorization: `Bearer ${token}` } : {}
-    });
-    if (!res.ok) {
-      const hint = res.status === 401 ? " \u2014 the server requires a token; pass --token or use the argent:// link from `server start`" : res.status === 403 ? " \u2014 the server refused this host (DNS-rebinding guard); reach it by its bind host or start it with --host" : "";
-      return { ok: false, error: `${res.status} ${res.statusText}${hint}` };
-    }
-    return { ok: true };
-  } catch (err) {
-    return { ok: false, error: err instanceof Error ? err.message : String(err) };
-  } finally {
-    clearTimeout(timer);
-  }
-}
-function printRestartHint() {
-  console.log(
-    import_picocolors.default.dim("Restart your editor to apply the change to any running `argent mcp` session.")
-  );
-}
-function printSecurityCaveat(host, token, url) {
-  if (isLoopback2(host)) return;
-  const tls = url.startsWith("https://");
-  if (tls) {
-    if (!token) {
-      process.stderr.write(
-        import_picocolors.default.yellow(
-          `WARNING: ${host} is reached over HTTPS but with NO token \u2014 anyone who can reach the URL can drive the server. Pair with a token.
-`
-        )
-      );
-    }
-    return;
-  }
-  if (token) {
-    process.stderr.write(
-      import_picocolors.default.dim(
-        `Note: ${host} is reached over plain HTTP (bearer-token auth, no TLS). Keep this link to a trusted network or VPN, or front it with an https:// tunnel.
-`
-      )
-    );
-    return;
-  }
-  process.stderr.write(
-    import_picocolors.default.yellow(
-      `WARNING: linked target ${host} is non-loopback and has NO token \u2014 tool calls travel over plain HTTP with no auth. Treat this link as trusted-network-only, or pair with a token (start the server without --no-auth).
-`
-    )
-  );
-}
-async function link(argv) {
-  let flags2;
-  try {
-    flags2 = parseLinkFlags(argv);
-  } catch (err) {
-    if (err instanceof StartFlagError) {
-      console.error(`Error: ${err.message}
-`);
-      printLinkHelp();
-      process.exit(2);
-    }
-    throw err;
-  }
-  if (flags2.help) {
-    printLinkHelp();
-    return;
-  }
-  if (flags2.yes && flags2.host === null) {
-    console.error("Error: --yes requires --host (port defaults to 3001).\n");
-    printLinkHelp();
-    process.exit(2);
-  }
-  const existing = await readLinkConfig();
-  let host;
-  if (flags2.host !== null) {
-    host = flags2.host;
-  } else {
-    ge(import_picocolors.default.bgCyan(import_picocolors.default.black(" argent link ")));
-    if (existing) {
-      R2.info(`Current link: ${import_picocolors.default.cyan(existing.url)} (${existing.createdAt})`);
-    }
-    host = await promptHost(existing);
-  }
-  let port;
-  if (flags2.port !== null) {
-    port = flags2.port;
-  } else if (flags2.yes) {
-    port = 3001;
-  } else {
-    port = await promptPort(existing);
-  }
-  const token = flags2.token ?? (existing && existing.host === host && existing.port === port ? existing.token : void 0);
-  let url = flags2.url ?? formatUrl(host, port);
-  if (!flags2.yes && existing) {
-    if (existing.url === url) {
-      R2.info(`Already linked to ${import_picocolors.default.cyan(url)}.`);
-      ye("No changes.");
-      return;
-    }
-    const overwrite = await ue({
-      message: `Replace existing link ${import_picocolors.default.dim(existing.url)} with ${import_picocolors.default.cyan(url)}?`,
-      initialValue: true
-    });
-    if (q(overwrite) || !overwrite) {
-      me("Link cancelled.");
-      process.exit(0);
-    }
-  }
-  if (!flags2.noVerify) {
-    while (true) {
-      const spinnerActive = !flags2.yes;
-      let spinner = null;
-      if (spinnerActive) {
-        spinner = ft();
-        spinner.start(`Verifying tool-server at ${url}...`);
-      }
-      const result = await preflightHealth(url, token);
-      if (result.ok) {
-        if (spinner) spinner.stop(import_picocolors.default.green("Tool-server reachable."));
-        break;
-      }
-      if (spinner) spinner.stop(import_picocolors.default.red("Verification failed."));
-      const detail = result.error ? ` (${result.error})` : "";
-      if (flags2.yes) {
-        console.error(
-          `Error: pre-flight GET ${url}/tools failed${detail}. Make sure the remote tool-server is running, or pass --no-verify to skip.`
-        );
-        process.exit(1);
-      }
-      R2.error(`pre-flight GET ${url}/tools failed${detail}.`);
-      const action = await xe({
-        message: "How would you like to proceed?",
-        options: [
-          { value: "retry", label: "Retry verification" },
-          { value: "modify", label: "Modify host and port, then retry" },
-          { value: "skip", label: "Skip verification and save anyway" },
-          { value: "cancel", label: "Cancel" }
-        ],
-        initialValue: "retry"
-      });
-      if (q(action) || action === "cancel") {
-        me("Link cancelled.");
-        process.exit(0);
-      }
-      if (action === "skip") break;
-      if (action === "modify") {
-        host = await promptHost(existing, host);
-        port = await promptPort(existing, port);
-        url = formatUrl(host, port);
-      }
-    }
-  }
-  const cfg = {
-    url,
-    host,
-    port,
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-    ...token ? { token } : {}
-  };
-  await writeLinkConfig(cfg);
-  if (existing && existing.url !== url) {
-    console.log(`${import_picocolors.default.green("\u2713")} Link updated: ${import_picocolors.default.dim(existing.url)} \u2192 ${import_picocolors.default.cyan(url)}`);
-  } else {
-    console.log(`${import_picocolors.default.green("\u2713")} Linked: ${import_picocolors.default.cyan(url)}`);
-  }
-  if (token) console.log(import_picocolors.default.dim("  auth: token stored in ~/.argent/link.json (0600)"));
-  printSecurityCaveat(host, token, url);
-  if (process.env.ARGENT_TOOLS_URL) {
-    console.log(
-      import_picocolors.default.yellow(
-        `Note: ARGENT_TOOLS_URL=${process.env.ARGENT_TOOLS_URL} is set in your environment and takes precedence over the link.`
-      )
-    );
-  }
-  printRestartHint();
-}
-async function unlink3(argv) {
-  let flags2;
-  try {
-    flags2 = parseUnlinkFlags(argv);
-  } catch (err) {
-    if (err instanceof StartFlagError) {
-      console.error(`Error: ${err.message}
+  argent link --host 10.0.0.42 --yes --no-verify
+                                             Saves immediately, no health check.
+
+Security:
+  The token (if any) is stored 0600 and sent as a bearer header. An http:// link
+  has no TLS \u2014 treat any non-loopback http link as trusted-network-only. Prefer
+  an https:// tunnel/proxy when crossing untrusted networks.
+
+Notes:
+  - If ARGENT_TOOLS_URL is also set in your environment, it overrides the link.
+  - To stop using the remote target, run \`argent unlink\`.
+  - \`argent server start/stop/status\` manage the local tool-server lifecycle
+    and are unaffected by linking.
+  - Restart your editor (Claude / Cursor / VS Code) afterwards \u2014 a running
+    \`argent mcp\` process caches the target at startup and won't pick up the
+    new link until it's relaunched.
 `);
-      printUnlinkHelp();
-      process.exit(2);
-    }
-    throw err;
-  }
-  if (flags2.help) {
-    printUnlinkHelp();
-    return;
-  }
-  const existing = await readLinkConfig();
-  if (!existing) {
-    console.log("Not currently linked \u2014 already using local tool-server.");
-    return;
-  }
-  if (!flags2.yes) {
-    const confirmed = await ue({
-      message: `Remove link to ${import_picocolors.default.cyan(existing.url)}?`,
-      initialValue: true
-    });
-    if (q(confirmed) || !confirmed) {
-      me("Unlink cancelled.");
-      process.exit(0);
-    }
-  }
-  await clearLinkConfig();
-  console.log(`${import_picocolors.default.green("\u2713")} Unlinked from ${import_picocolors.default.dim(existing.url)}.`);
-  if (process.env.ARGENT_TOOLS_URL) {
-    console.log(
-      import_picocolors.default.yellow(
-        `The env var ARGENT_TOOLS_URL is also set in your shell (=${process.env.ARGENT_TOOLS_URL}) and takes precedence \u2014 unset it manually if you want fully local behaviour.`
-      )
-    );
-  }
-  printRestartHint();
 }
+function printUnlinkHelp() {
+  console.log(`Usage: argent unlink [flags]
 
-// ../argent-cli/src/flags.ts
-import * as fs4 from "node:fs";
-import * as path5 from "node:path";
-import { homedir as homedir4 } from "node:os";
-var FLAG_REGISTRY = [
-  // {
-  //   name: "example-flag",
-  //   description: "One-line summary shown by `argent flags`.",
-  // },
-];
-function getFlagDefinition(name, registry = FLAG_REGISTRY) {
-  return registry.find((def) => def.name === name);
+Remove the persisted remote tool-server link (~/.argent/link.json) and return
+to default local auto-spawn behaviour.
+
+Flags:
+  --yes, -y     Skip the confirmation prompt.
+  --help, -h    Show this help.
+
+Examples:
+  argent unlink         Confirms, then removes the link.
+  argent unlink --yes   Removes without confirmation. Safe in scripts.
+
+Notes:
+  - No-op (exit 0) if no link is currently set.
+  - If ARGENT_TOOLS_URL is also set in your environment, it still takes
+    precedence after unlinking \u2014 unset it manually for fully local behaviour.
+  - This does not stop or start any tool-server process. Use
+    \`argent server stop\` if you also want to terminate a running local server.
+  - Restart your editor afterwards \u2014 a running \`argent mcp\` process won't
+    revert to local auto-spawn until it's relaunched.
+`);
 }
-var PROJECT_MARKERS = [".argent", ".git", "package.json"];
-function resolveProjectRoot(startDir) {
-  const initial = path5.resolve(startDir);
-  let current = initial;
-  while (true) {
-    for (const marker of PROJECT_MARKERS) {
-      if (fs4.existsSync(path5.join(current, marker))) return current;
+async function promptHost(existing, initial) {
+  const hostInput = await Pe({
+    message: "Remote host or IP to connect to",
+    placeholder: existing?.host ?? "127.0.0.1",
+    initialValue: initial ?? existing?.host,
+    validate(value) {
+      if (!value || !value.trim()) return "Host cannot be empty.";
+      const trimmed = value.trim();
+      if (WILDCARD_HOSTS.has(trimmed)) {
+        return `${trimmed} is a bind address, not a connect address \u2014 use 127.0.0.1 or the actual reachable host.`;
+      }
     }
-    const parent = path5.dirname(current);
-    if (parent === current) return initial;
-    current = parent;
+  });
+  if (q(hostInput)) {
+    me("Link cancelled.");
+    process.exit(0);
   }
+  return hostInput.trim();
 }
-function getFlagsPath(scope, options = {}) {
-  const home = options.homeDir ?? homedir4();
-  if (scope === "global") {
-    return path5.join(home, ".argent", "flags.json");
+async function promptPort(existing, initial) {
+  const defaultPort = initial ?? existing?.port ?? 3001;
+  const portInput = await Pe({
+    message: "Remote port",
+    placeholder: String(defaultPort),
+    initialValue: String(defaultPort),
+    validate(value) {
+      if (!value || !value.trim()) return "Port cannot be empty.";
+      try {
+        validateConnectPort(value.trim());
+      } catch (err) {
+        if (err instanceof StartFlagError) return err.message;
+        throw err;
+      }
+    }
+  });
+  if (q(portInput)) {
+    me("Link cancelled.");
+    process.exit(0);
   }
-  const cwd = options.cwd ?? process.cwd();
-  return path5.join(resolveProjectRoot(cwd), ".argent", "flags.json");
+  return validateConnectPort(portInput.trim());
 }
-function readFlagsFile(filePath) {
-  let raw;
-  try {
-    raw = fs4.readFileSync(filePath, "utf8");
-  } catch {
-    return {};
-  }
-  let parsed;
+async function preflightHealth(url, token) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 3e3);
   try {
-    parsed = JSON.parse(raw);
-  } catch {
-    return {};
-  }
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
-  const flags2 = parsed.flags;
-  if (!flags2 || typeof flags2 !== "object" || Array.isArray(flags2)) return {};
-  const out = {};
-  for (const [k2, v2] of Object.entries(flags2)) {
-    if (typeof v2 === "boolean") out[k2] = v2;
-  }
-  return out;
-}
-function writeFlagsFile(filePath, flags2) {
-  if (Object.keys(flags2).length === 0) {
-    if (fs4.existsSync(filePath)) fs4.rmSync(filePath, { force: true });
-    const parent = path5.dirname(filePath);
-    try {
-      if (fs4.existsSync(parent) && fs4.readdirSync(parent).length === 0) {
-        fs4.rmdirSync(parent);
-      }
-    } catch {
+    const res = await fetch(`${url}/tools`, {
+      signal: controller.signal,
+      headers: token ? { Authorization: `Bearer ${token}` } : {}
+    });
+    if (!res.ok) {
+      const hint = res.status === 401 ? " \u2014 the server requires a token; pass --token or use the argent:// link from `server start`" : res.status === 403 ? " \u2014 the server refused this host (DNS-rebinding guard); reach it by its bind host or start it with --host" : "";
+      return { ok: false, error: `${res.status} ${res.statusText}${hint}` };
     }
-    return;
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+  } finally {
+    clearTimeout(timer);
   }
-  fs4.mkdirSync(path5.dirname(filePath), { recursive: true });
-  const tmp = `${filePath}.${process.pid}.tmp`;
-  fs4.writeFileSync(tmp, JSON.stringify({ flags: flags2 }, null, 2) + "\n");
-  fs4.renameSync(tmp, filePath);
-}
-function readFlags(scope, options = {}) {
-  return readFlagsFile(getFlagsPath(scope, options));
-}
-function setFlag(name, value, scope, options = {}) {
-  const filePath = getFlagsPath(scope, options);
-  const current = readFlagsFile(filePath);
-  current[name] = value;
-  writeFlagsFile(filePath, current);
-}
-function unsetFlag(name, scope, options = {}) {
-  const filePath = getFlagsPath(scope, options);
-  const current = readFlagsFile(filePath);
-  if (!Object.hasOwn(current, name)) return false;
-  delete current[name];
-  writeFlagsFile(filePath, current);
-  return true;
 }
-function isFlagEnabled(name, options = {}) {
-  const projectFlags = readFlags("project", options);
-  if (Object.hasOwn(projectFlags, name)) return projectFlags[name];
-  const globalFlags = readFlags("global", options);
-  if (Object.hasOwn(globalFlags, name)) return globalFlags[name];
-  return false;
+function printRestartHint() {
+  console.log(
+    import_picocolors2.default.dim("Restart your editor to apply the change to any running `argent mcp` session.")
+  );
 }
-var FLAG_NAME_RE = /^[a-zA-Z][a-zA-Z0-9._-]*$/;
-function parseToggleArgs(argv, command) {
-  let name = null;
-  let scope = "global";
-  let positionalOnly = false;
-  for (let i = 0; i < argv.length; i++) {
-    const tok = argv[i];
-    if (positionalOnly) {
-      if (name !== null) throw new Error(`Unexpected extra argument: "${tok}"`);
-      name = tok;
-      continue;
-    }
-    if (tok === "--") {
-      positionalOnly = true;
-      continue;
-    }
-    if (tok === "--scope") {
-      const v2 = argv[i + 1];
-      if (v2 === void 0) throw new Error("--scope requires a value (project|global)");
-      scope = parseScope(v2);
-      i += 1;
-      continue;
-    }
-    if (tok.startsWith("--scope=")) {
-      scope = parseScope(tok.slice("--scope=".length));
-      continue;
-    }
-    if (tok.startsWith("--")) {
-      throw new Error(`Unknown flag: ${tok}`);
-    }
-    if (name !== null) {
-      throw new Error(`Unexpected extra argument: "${tok}"`);
+function printSecurityCaveat(host, token, url) {
+  if (isLoopback2(host)) return;
+  const tls = url.startsWith("https://");
+  if (tls) {
+    if (!token) {
+      process.stderr.write(
+        import_picocolors2.default.yellow(
+          `WARNING: ${host} is reached over HTTPS but with NO token \u2014 anyone who can reach the URL can drive the server. Pair with a token.
+`
+        )
+      );
     }
-    name = tok;
-  }
-  if (name === null) {
-    throw new Error(`Usage: argent ${command} <flag-name> [--scope project|global]`);
-  }
-  if (!FLAG_NAME_RE.test(name)) {
-    throw new Error(
-      `Invalid flag name "${name}". Must start with a letter and contain only letters, digits, ".", "_", or "-".`
+    return;
+  }
+  if (token) {
+    process.stderr.write(
+      import_picocolors2.default.dim(
+        `Note: ${host} is reached over plain HTTP (bearer-token auth, no TLS). Keep this link to a trusted network or VPN, or front it with an https:// tunnel.
+`
+      )
     );
+    return;
   }
-  return { name, scope };
-}
-function parseScope(raw) {
-  if (raw === "global" || raw === "project") return raw;
-  throw new Error(`--scope must be "project" or "global", got "${raw}"`);
+  process.stderr.write(
+    import_picocolors2.default.yellow(
+      `WARNING: linked target ${host} is non-loopback and has NO token \u2014 tool calls travel over plain HTTP with no auth. Treat this link as trusted-network-only, or pair with a token (start the server without --no-auth).
+`
+    )
+  );
 }
-function printToggleHelp(command) {
-  const summary = command === "enable" ? "Enable a predefined feature flag (see `argent flags`) at the chosen scope." : "Remove a feature flag entry at the chosen scope. Falls back to the global value if set; otherwise the flag is treated as off.";
-  console.log(`Usage: argent ${command} <flag-name> [--scope project|global]
-
-${summary}
-
-Storage:
-  ~/.argent/flags.json                 (global, default)
-  <project-root>/.argent/flags.json    (project, with --scope project)
-
-Options:
-  --scope <global|project>   Where to write (default: global)
-  --help, -h                 Show this help
+async function link(argv) {
+  let flags2;
+  try {
+    flags2 = parseLinkFlags(argv);
+  } catch (err) {
+    if (err instanceof StartFlagError) {
+      console.error(`Error: ${err.message}
 `);
-}
-function runToggle(argv, command, registry) {
-  if (argv.includes("--help") || argv.includes("-h")) {
-    printToggleHelp(command);
+      printLinkHelp();
+      process.exit(2);
+    }
+    throw err;
+  }
+  if (flags2.help) {
+    printLinkHelp();
     return;
   }
-  let parsed;
-  try {
-    parsed = parseToggleArgs(argv, command);
-  } catch (err) {
-    console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+  if (flags2.yes && flags2.host === null) {
+    console.error("Error: --yes requires --host (port defaults to 3001).\n");
+    printLinkHelp();
     process.exit(2);
   }
-  if (command === "enable" && getFlagDefinition(parsed.name, registry) === void 0) {
-    console.error(
-      `Error: Unknown feature flag "${parsed.name}". Run \`argent flags\` to see available flags.`
-    );
-    process.exit(2);
+  const existing = await readLinkConfig();
+  let host;
+  if (flags2.host !== null) {
+    host = flags2.host;
+  } else {
+    ge(import_picocolors2.default.bgCyan(import_picocolors2.default.black(" argent link ")));
+    if (existing) {
+      R2.info(`Current link: ${import_picocolors2.default.cyan(existing.url)} (${existing.createdAt})`);
+    }
+    host = await promptHost(existing);
   }
-  const filePath = getFlagsPath(parsed.scope);
-  try {
-    if (command === "enable") {
-      setFlag(parsed.name, true, parsed.scope);
-    } else {
-      unsetFlag(parsed.name, parsed.scope);
+  let port;
+  if (flags2.port !== null) {
+    port = flags2.port;
+  } else if (flags2.yes) {
+    port = 3001;
+  } else {
+    port = await promptPort(existing);
+  }
+  const token = flags2.token ?? (existing && existing.host === host && existing.port === port ? existing.token : void 0);
+  let url = flags2.url ?? formatUrl(host, port);
+  if (!flags2.yes && existing) {
+    if (existing.url === url) {
+      R2.info(`Already linked to ${import_picocolors2.default.cyan(url)}.`);
+      ye("No changes.");
+      return;
+    }
+    const overwrite = await ue({
+      message: `Replace existing link ${import_picocolors2.default.dim(existing.url)} with ${import_picocolors2.default.cyan(url)}?`,
+      initialValue: true
+    });
+    if (q(overwrite) || !overwrite) {
+      me("Link cancelled.");
+      process.exit(0);
     }
-  } catch (err) {
-    console.error(`Failed to ${command} flag: ${err instanceof Error ? err.message : String(err)}`);
-    process.exit(1);
   }
-  if (command === "enable") {
-    console.log(`Enabled flag "${parsed.name}" (${parsed.scope}). Stored at ${filePath}.`);
+  if (!flags2.noVerify) {
+    while (true) {
+      const spinnerActive = !flags2.yes;
+      let spinner = null;
+      if (spinnerActive) {
+        spinner = ft();
+        spinner.start(`Verifying tool-server at ${url}...`);
+      }
+      const result = await preflightHealth(url, token);
+      if (result.ok) {
+        if (spinner) spinner.stop(import_picocolors2.default.green("Tool-server reachable."));
+        break;
+      }
+      if (spinner) spinner.stop(import_picocolors2.default.red("Verification failed."));
+      const detail = result.error ? ` (${result.error})` : "";
+      if (flags2.yes) {
+        console.error(
+          `Error: pre-flight GET ${url}/tools failed${detail}. Make sure the remote tool-server is running, or pass --no-verify to skip.`
+        );
+        process.exit(1);
+      }
+      R2.error(`pre-flight GET ${url}/tools failed${detail}.`);
+      const action = await xe({
+        message: "How would you like to proceed?",
+        options: [
+          { value: "retry", label: "Retry verification" },
+          { value: "modify", label: "Modify host and port, then retry" },
+          { value: "skip", label: "Skip verification and save anyway" },
+          { value: "cancel", label: "Cancel" }
+        ],
+        initialValue: "retry"
+      });
+      if (q(action) || action === "cancel") {
+        me("Link cancelled.");
+        process.exit(0);
+      }
+      if (action === "skip") break;
+      if (action === "modify") {
+        host = await promptHost(existing, host);
+        port = await promptPort(existing, port);
+        url = formatUrl(host, port);
+      }
+    }
+  }
+  const cfg = {
+    url,
+    host,
+    port,
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    ...token ? { token } : {}
+  };
+  await writeLinkConfig(cfg);
+  if (existing && existing.url !== url) {
+    console.log(`${import_picocolors2.default.green("\u2713")} Link updated: ${import_picocolors2.default.dim(existing.url)} \u2192 ${import_picocolors2.default.cyan(url)}`);
   } else {
-    console.log(`Disabled flag "${parsed.name}" (${parsed.scope}).`);
+    console.log(`${import_picocolors2.default.green("\u2713")} Linked: ${import_picocolors2.default.cyan(url)}`);
   }
+  if (token) console.log(import_picocolors2.default.dim("  auth: token stored in ~/.argent/link.json (0600)"));
+  printSecurityCaveat(host, token, url);
+  if (process.env.ARGENT_TOOLS_URL) {
+    console.log(
+      import_picocolors2.default.yellow(
+        `Note: ARGENT_TOOLS_URL=${process.env.ARGENT_TOOLS_URL} is set in your environment and takes precedence over the link.`
+      )
+    );
+  }
+  printRestartHint();
 }
-function enable(argv, registry = FLAG_REGISTRY) {
-  runToggle(argv, "enable", registry);
-}
-function disable(argv, registry = FLAG_REGISTRY) {
-  runToggle(argv, "disable", registry);
-}
-function flags(argv, registry = FLAG_REGISTRY) {
-  if (argv.includes("--help") || argv.includes("-h")) {
-    console.log(`Usage: argent flags [--json]
-
-List the available feature flags and their current state. Flags are
-predefined; project-scoped values override global ones.
-
-Options:
-  --json   Print machine-readable JSON
+async function unlink3(argv) {
+  let flags2;
+  try {
+    flags2 = parseUnlinkFlags(argv);
+  } catch (err) {
+    if (err instanceof StartFlagError) {
+      console.error(`Error: ${err.message}
 `);
+      printUnlinkHelp();
+      process.exit(2);
+    }
+    throw err;
+  }
+  if (flags2.help) {
+    printUnlinkHelp();
     return;
   }
-  const json = argv.includes("--json");
-  const projectFlags = readFlags("project");
-  const globalFlags = readFlags("global");
-  const effective = {};
-  for (const [k2, v2] of Object.entries(globalFlags)) effective[k2] = { value: v2, scope: "global" };
-  for (const [k2, v2] of Object.entries(projectFlags)) effective[k2] = { value: v2, scope: "project" };
-  const registryView = registry.map((def) => {
-    const eff = Object.hasOwn(effective, def.name) ? effective[def.name] : void 0;
-    return {
-      name: def.name,
-      description: def.description,
-      enabled: eff?.value ?? false,
-      scope: eff?.scope ?? null
-    };
-  });
-  const known = new Set(registry.map((def) => def.name));
-  const unrecognized = Object.keys(effective).filter((name) => !known.has(name)).sort().map((name) => ({ name, enabled: effective[name].value, scope: effective[name].scope }));
-  if (json) {
-    console.log(
-      JSON.stringify(
-        {
-          flags: registryView,
-          unrecognized,
-          global: globalFlags,
-          project: projectFlags,
-          effective,
-          paths: {
-            global: getFlagsPath("global"),
-            project: getFlagsPath("project")
-          }
-        },
-        null,
-        2
-      )
-    );
+  const existing = await readLinkConfig();
+  if (!existing) {
+    console.log("Not currently linked \u2014 already using local tool-server.");
     return;
   }
-  if (registryView.length === 0) {
-    console.log("No feature flags are defined.");
-  } else {
-    console.log("Feature flags (project overrides global):");
-    const maxName = registryView.reduce((m2, f2) => Math.max(m2, f2.name.length), 0);
-    for (const f2 of registryView) {
-      const stateLabel = f2.enabled ? "enabled" : "disabled";
-      const scopeLabel = f2.scope ? ` (${f2.scope})` : "";
-      console.log(`  ${f2.name.padEnd(maxName, " ")}  ${stateLabel.padEnd(8)}${scopeLabel}`);
-      console.log(`  ${" ".repeat(maxName)}  ${f2.description}`);
+  if (!flags2.yes) {
+    const confirmed = await ue({
+      message: `Remove link to ${import_picocolors2.default.cyan(existing.url)}?`,
+      initialValue: true
+    });
+    if (q(confirmed) || !confirmed) {
+      me("Unlink cancelled.");
+      process.exit(0);
     }
   }
-  if (unrecognized.length > 0) {
-    console.log("\nStored but no longer recognized (safe to `argent disable`):");
-    const maxName = unrecognized.reduce((m2, f2) => Math.max(m2, f2.name.length), 0);
-    for (const f2 of unrecognized) {
-      const stateLabel = f2.enabled ? "enabled" : "disabled";
-      console.log(`  ${f2.name.padEnd(maxName, " ")}  ${stateLabel.padEnd(8)} (${f2.scope})`);
-    }
+  await clearLinkConfig();
+  console.log(`${import_picocolors2.default.green("\u2713")} Unlinked from ${import_picocolors2.default.dim(existing.url)}.`);
+  if (process.env.ARGENT_TOOLS_URL) {
+    console.log(
+      import_picocolors2.default.yellow(
+        `The env var ARGENT_TOOLS_URL is also set in your shell (=${process.env.ARGENT_TOOLS_URL}) and takes precedence \u2014 unset it manually if you want fully local behaviour.`
+      )
+    );
   }
-  console.log(`
-  Global:  ${getFlagsPath("global")}`);
-  console.log(`  Project: ${getFlagsPath("project")}`);
+  printRestartHint();
 }
 export {
   FLAG_REGISTRY,