@graph8/sdk 0.361.0 → 0.370.0

package/dist/cli.js

@@ -36,8 +36,8 @@ __export(cli_exports, {
 });
 module.exports = __toCommonJS(cli_exports);
 var import_node_child_process = require("child_process");
-var import_node_fs5 = __toESM(require("fs"));
-var import_node_path5 = __toESM(require("path"));
+var import_node_fs9 = __toESM(require("fs"));
+var import_node_path10 = __toESM(require("path"));
 
 // src/agentSetup.ts
 var ALL_TARGETS = ["claude", "codex", "cursor"];
@@ -119,9 +119,9 @@ ${section}
 }
 function planAgentSetup(targets, read, catalog) {
   const plans = [];
-  const add = (target, path6, next) => {
-    const current = read(path6);
-    plans.push({ target, path: path6, content: next, action: current === null ? "create" : current === next ? "unchanged" : "update" });
+  const add = (target, path11, next) => {
+    const current = read(path11);
+    plans.push({ target, path: path11, content: next, action: current === null ? "create" : current === next ? "unchanged" : "update" });
   };
   for (const target of targets) {
     if (target === "claude") add(target, ".claude/skills/graph8-sdk/SKILL.md", claudeSkill(catalog));
@@ -154,1622 +154,21 @@ ${INIT_AGENT_USAGE}`);
 
 // src/blocks/add.ts
 var import_node_crypto = require("crypto");
-var import_node_fs2 = __toESM(require("fs"));
-var import_node_path2 = __toESM(require("path"));
+var import_node_fs4 = __toESM(require("fs"));
+var import_node_path5 = __toESM(require("path"));
 
 // src/version.ts
-var SDK_VERSION = "0.361.0";
+var SDK_VERSION = "0.370.0";
 var SDK_CLIENT_ID = `js-sdk/${SDK_VERSION}`;
 
-// src/blocks/registry.ts
-var import_node_fs = __toESM(require("fs"));
+// src/blocks/paths.ts
 var import_node_path = __toESM(require("path"));
-function arr(v) {
-  return Array.isArray(v) ? v : [];
-}
-function readJson(file) {
-  try {
-    const parsed = JSON.parse(import_node_fs.default.readFileSync(file, "utf8"));
-    return parsed && typeof parsed === "object" ? parsed : null;
-  } catch {
-    return null;
-  }
-}
-function toBlock(raw, dir, root) {
-  if (typeof raw.id !== "string" || !raw.id) return null;
-  return {
-    id: raw.id,
-    title: typeof raw.title === "string" ? raw.title : raw.id,
-    summary: typeof raw.summary === "string" ? raw.summary : "",
-    features: arr(raw.features),
-    dependsOn: arr(raw.dependsOn),
-    operations: arr(raw.operations),
-    components: arr(raw.components),
-    hooks: arr(raw.hooks),
-    lib: arr(raw.lib),
-    server: arr(raw.server),
-    recipes: arr(raw.recipes),
-    prerequisites: arr(raw.prerequisites),
-    scopes: arr(raw.scopes),
-    defaults: arr(raw.defaults),
-    peerDependencies: raw.peerDependencies ?? {},
-    dir,
-    root
-  };
-}
-function loadRegistry(blocksRoot) {
-  const blocks = [];
-  if (import_node_fs.default.existsSync(blocksRoot)) {
-    for (const entry of import_node_fs.default.readdirSync(blocksRoot, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
-      if (!entry.isDirectory()) continue;
-      const root = import_node_path.default.join(blocksRoot, entry.name);
-      const raw = readJson(import_node_path.default.join(root, "block.json"));
-      const block = raw && toBlock(raw, entry.name, root);
-      if (block) blocks.push(block);
-    }
-  }
-  const stacks = [];
-  const stacksDir = import_node_path.default.join(import_node_path.default.dirname(blocksRoot), "stacks");
-  if (import_node_fs.default.existsSync(stacksDir)) {
-    for (const file of import_node_fs.default.readdirSync(stacksDir).filter((f) => f.endsWith(".json")).sort()) {
-      const raw = readJson(import_node_path.default.join(stacksDir, file));
-      if (!raw || typeof raw.id !== "string") continue;
-      stacks.push({
-        id: raw.id,
-        title: typeof raw.title === "string" ? raw.title : raw.id,
-        summary: typeof raw.summary === "string" ? raw.summary : "",
-        status: raw.status === "planned" ? "planned" : "available",
-        blocks: arr(raw.blocks),
-        nav: arr(raw.nav)
-      });
-    }
-  }
-  return { blocks, stacks };
-}
-function findBlock(reg, id) {
-  return reg.blocks.find((b) => b.id === id);
-}
-function resolveWithDeps(reg, ids) {
-  const ordered = [];
-  const done = /* @__PURE__ */ new Set();
-  const visiting = [];
-  const visit = (id) => {
-    if (done.has(id)) return;
-    if (visiting.includes(id)) throw new Error(`dependency cycle: ${[...visiting, id].join(" -> ")}`);
-    const block = findBlock(reg, id);
-    if (!block) {
-      const from = visiting.length ? ` (required by ${visiting[visiting.length - 1]})` : "";
-      throw new Error(`unknown block "${id}"${from}. Run \`graph8-sdk list\` to see the available blocks.`);
-    }
-    visiting.push(id);
-    for (const dep of block.dependsOn) visit(dep);
-    visiting.pop();
-    done.add(id);
-    ordered.push(block);
-  };
-  ids.forEach(visit);
-  return ordered;
-}
-function searchBlocks(reg, text) {
-  const needle = text.trim().toLowerCase();
-  if (!needle) return [];
-  return reg.blocks.filter(
-    (b) => [b.id, b.title, b.summary, ...b.features, ...b.components.map((c) => c.name)].some((s) => s.toLowerCase().includes(needle))
-  );
-}
-function searchStacks(reg, text) {
-  const needle = text.trim().toLowerCase();
-  if (!needle) return [];
-  return reg.stacks.filter((s) => [s.id, s.title, s.summary].some((x) => x.toLowerCase().includes(needle)));
-}
-function blockSummary(b) {
-  return { id: b.id, title: b.title, summary: b.summary, dependsOn: b.dependsOn, components: b.components.map((c) => c.name) };
-}
-function stackStatus(reg, s) {
-  const missing = s.blocks.filter((id) => !findBlock(reg, id));
-  return { status: missing.length ? "planned" : "available", missing };
-}
-function stackSummary(s, reg) {
-  const base = { id: s.id, title: s.title, summary: s.summary, blocks: s.blocks };
-  if (!reg) return base;
-  const { status, missing } = stackStatus(reg, s);
-  return { ...base, status, ...missing.length ? { missingBlocks: missing } : {} };
-}
-function catalogSection(reg) {
-  if (!reg.blocks.length && !reg.stacks.length) return void 0;
-  const lines = ["### graph8 blocks", "", "Ready-made, copy-in UI + hooks per graph8 feature. Pick from this list instead of reading every README:", ""];
-  for (const b of reg.blocks) {
-    const deps = b.dependsOn.length ? ` (needs ${b.dependsOn.join(", ")})` : "";
-    lines.push(`- block \`${b.id}\`: ${b.summary}${deps}`);
-  }
-  for (const s of reg.stacks) {
-    const { missing } = stackStatus(reg, s);
-    const planned = missing.length ? ` [planned, not creatable yet: missing blocks ${missing.join(", ")}]` : "";
-    lines.push(`- stack \`${s.id}\`: ${s.summary} (blocks: ${s.blocks.join(", ")})${planned}`);
-  }
-  lines.push(
-    "",
-    "Add one: `npx @graph8/sdk add <block>[/<Component>]` (dependencies and the `foundation` block come with it). Find one:",
-    "`npx @graph8/sdk list` / `search <text>`. Check setup: `npx @graph8/sdk doctor --blocks a,b`."
-  );
-  if (reg.stacks.some((s) => !stackStatus(reg, s).missing.length)) lines.push("Start a whole app from an available stack: `npx @graph8/sdk create <stack> <dir>` (Next.js + the stack's blocks wired into a sidebar).");
-  return lines.join("\n");
-}
-
-// src/blocks/add.ts
-var ADD_USAGE = `Usage: npx @graph8/sdk add <block>[/<Component>] [options]
-
-Copy a graph8 block (components, hooks, recipes) into your app. The block's
-dependencies (always including \`foundation\`) are added first.
-  --dir <path>      project root (default: current directory)
-  --target <path>   where to copy, relative to --dir (default: components/g8)
-  --dry-run         print what would change, write and install nothing
-  --force           overwrite files that differ from the template
-  --no-install      do not install missing peer dependencies
-Existing files are never overwritten without --force. Installed blocks are
-recorded in graph8.json so re-runs do nothing.`;
-function parseAddArgs(argv) {
-  const o = { spec: "", dir: ".", dryRun: false, force: false, install: true };
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    const [flag, inline] = arg.startsWith("--") && arg.includes("=") ? [arg.slice(0, arg.indexOf("=")), arg.slice(arg.indexOf("=") + 1)] : [arg, void 0];
-    const value = () => {
-      const v = inline ?? argv[++i];
-      if (v === void 0 || v.startsWith("--")) throw new Error(`${flag} needs a value
-
-${ADD_USAGE}`);
-      return v;
-    };
-    if (flag === "--dir") o.dir = value();
-    else if (flag === "--target") o.target = value();
-    else if (arg === "--dry-run") o.dryRun = true;
-    else if (arg === "--force") o.force = true;
-    else if (arg === "--no-install") o.install = false;
-    else if (arg.startsWith("-")) throw new Error(`unknown option ${arg}
-
-${ADD_USAGE}`);
-    else if (!o.spec) o.spec = arg;
-    else throw new Error(`unexpected argument ${arg}
-
-${ADD_USAGE}`);
-  }
-  if (!o.spec) throw new Error(`add needs a block name
-
-${ADD_USAGE}`);
-  return o;
-}
-function detectPackageManager(root) {
-  const has = (f) => import_node_fs2.default.existsSync(import_node_path2.default.join(root, f));
-  if (has("pnpm-lock.yaml")) return "pnpm";
-  if (has("yarn.lock")) return "yarn";
-  if (has("bun.lockb") || has("bun.lock")) return "bun";
-  return "npm";
-}
-function installCommand(pm, packages) {
-  const verb = pm === "npm" ? "install" : "add";
-  return { cmd: pm, args: [verb, ...packages] };
-}
-var sha = (s) => (0, import_node_crypto.createHash)("sha256").update(s).digest("hex");
-var posix = (p) => p.split(import_node_path2.default.sep).join("/");
+var posix = (p) => p.split(import_node_path.default.sep).join("/");
 function installedRel(rel) {
   const r = posix(rel);
   if (r === "block.json") return null;
   return r.startsWith("components/") ? r.slice("components/".length) : r;
 }
-function appTargeted(block) {
-  const m = /* @__PURE__ */ new Map();
-  for (const f of block.server) if (f.target && !f.target.startsWith("g8/")) m.set(posix(f.file), f.target);
-  return m;
-}
-function listFiles(dir, base = dir) {
-  const out = [];
-  for (const e of import_node_fs2.default.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
-    const full = import_node_path2.default.join(dir, e.name);
-    if (e.isDirectory()) out.push(...listFiles(full, base));
-    else out.push(posix(import_node_path2.default.relative(base, full)));
-  }
-  return out;
-}
-var IMPORT_RE = /(\bfrom\s*|\bimport\s*\(?\s*|\brequire\s*\(\s*)(["'])([^"'\n]+)\2/g;
-function relSpec(fromDir, toFile) {
-  const noExt = toFile;
-  let r = posix(import_node_path2.default.relative(fromDir, noExt));
-  if (!r.startsWith(".")) r = `./${r}`;
-  return r;
-}
-function g8AliasTarget(spec, ctx) {
-  const [seg, ...rest] = spec.split("/");
-  const reserved = ["components", "hooks", "lib", "server", "recipes"].includes(seg);
-  const owner = rest.length && !reserved ? ctx.reg.blocks.find((b) => b.id === seg || b.dir === seg) : void 0;
-  const block = owner ?? ctx.reg.blocks.find((b) => b.id === "foundation");
-  const sub = owner ? rest.join("/") : spec;
-  return import_node_path2.default.join(ctx.targetAbs, block?.dir ?? "_foundation", installedRel(sub) ?? sub);
-}
-function rewriteImports(content, ctx) {
-  return content.replace(IMPORT_RE, (whole, pre, q, spec) => {
-    if (spec.startsWith("@/g8/")) {
-      return `${pre}${q}${relSpec(ctx.destDir, g8AliasTarget(spec.slice("@/g8/".length), ctx))}${q}`;
-    }
-    if (spec.startsWith(".") && ctx.block && ctx.srcFile) {
-      const abs = import_node_path2.default.resolve(import_node_path2.default.dirname(ctx.srcFile), spec);
-      const relInBlock = import_node_path2.default.relative(ctx.block.root, abs);
-      if (relInBlock.startsWith("..")) return whole;
-      const mapped = installedRel(relInBlock);
-      if (mapped === null) return whole;
-      return `${pre}${q}${relSpec(ctx.destDir, import_node_path2.default.join(ctx.targetAbs, ctx.block.dir, mapped))}${q}`;
-    }
-    return whole;
-  });
-}
-function diffSummary(before, after) {
-  const count = (s) => {
-    const m = /* @__PURE__ */ new Map();
-    for (const l of s.split("\n")) m.set(l, (m.get(l) ?? 0) + 1);
-    return m;
-  };
-  const a = count(before);
-  const b = count(after);
-  let removed = 0;
-  let added = 0;
-  for (const [l, n] of a) removed += Math.max(0, n - (b.get(l) ?? 0));
-  for (const [l, n] of b) added += Math.max(0, n - (a.get(l) ?? 0));
-  return `+${added} -${removed} lines vs the template`;
-}
-function classify(abs, rel, content, force) {
-  if (!import_node_fs2.default.existsSync(abs)) return { rel, content, action: "create" };
-  const current = import_node_fs2.default.readFileSync(abs, "utf8");
-  if (current === content) return { rel, content, action: "unchanged" };
-  if (force) return { rel, content, action: "update", detail: diffSummary(current, content) };
-  return { rel, content, action: "skip", detail: `exists and differs (${diffSummary(current, content)}); use --force to overwrite` };
-}
-function readPkg(root) {
-  try {
-    return JSON.parse(import_node_fs2.default.readFileSync(import_node_path2.default.join(root, "package.json"), "utf8"));
-  } catch {
-    return null;
-  }
-}
-function missingPeers(blocks, pkg) {
-  const have = /* @__PURE__ */ new Set([
-    ...Object.keys(pkg.dependencies ?? {}),
-    ...Object.keys(pkg.devDependencies ?? {}),
-    ...Object.keys(pkg.peerDependencies ?? {}),
-    ...Object.keys(pkg.optionalDependencies ?? {})
-  ]);
-  const want = /* @__PURE__ */ new Map();
-  for (const b of blocks) for (const [name, range] of Object.entries(b.peerDependencies)) if (!want.has(name)) want.set(name, range);
-  return [...want].filter(([name]) => !have.has(name)).map(([name, range]) => `${name}@${range}`);
-}
-function parseSpec(spec) {
-  const [blockId, component, ...extra] = spec.split("/");
-  if (!blockId || extra.length) throw new Error(`invalid block "${spec}": use <block> or <block>/<Component>`);
-  return { blockId, component: component || void 0 };
-}
-function planBlock(block, only, reg, targetAbs, root, force) {
-  const skipComponentFiles = /* @__PURE__ */ new Set();
-  if (only) {
-    for (const c of block.components) if (c.name !== only) skipComponentFiles.add(posix(c.file));
-    const byStem = new Map(block.components.map((c) => [posix(c.file).replace(/\.[tj]sx?$/, ""), posix(c.file)]));
-    const start = block.components.find((c) => c.name === only);
-    const queue = start ? [posix(start.file)] : [];
-    while (queue.length) {
-      const file = queue.pop();
-      const text = import_node_fs2.default.readFileSync(import_node_path2.default.join(block.root, file), "utf8");
-      for (const m of text.matchAll(IMPORT_RE)) {
-        if (!m[3].startsWith(".")) continue;
-        const stem = posix(import_node_path2.default.relative(block.root, import_node_path2.default.resolve(block.root, import_node_path2.default.dirname(file), m[3]))).replace(/\.[tj]sx?$/, "");
-        const sibling = byStem.get(stem);
-        if (sibling && skipComponentFiles.delete(sibling)) queue.push(sibling);
-      }
-    }
-  }
-  const files = [];
-  const toApp = appTargeted(block);
-  for (const rel of listFiles(block.root)) {
-    if (skipComponentFiles.has(rel) || toApp.has(rel)) continue;
-    const mapped = installedRel(rel);
-    if (mapped === null) continue;
-    const destAbs = import_node_path2.default.join(targetAbs, block.dir, mapped);
-    const src = import_node_path2.default.join(block.root, rel);
-    const text = import_node_fs2.default.readFileSync(src, "utf8");
-    const content = rewriteImports(text, { reg, targetAbs, block, srcFile: src, destDir: import_node_path2.default.dirname(destAbs) });
-    files.push(classify(destAbs, posix(import_node_path2.default.relative(root, destAbs)), content, force));
-  }
-  return files;
-}
-var PROXY_CONTRACT = [
-  "This is not a Next.js project, so the proxy route was not written. Your server must provide the same contract:",
-  "  - handle every method on /api/g8/* (the browser calls these paths)",
-  "  - forward to ${G8_API_URL:-https://be.graph8.com}/api/v1/<rest of path>, same method, query and body",
-  "  - add the header `Authorization: Bearer $G8_API_KEY` on the server; never send the key to the browser",
-  "  - return the upstream status and JSON body unchanged"
-];
-function writeFile(root, f) {
-  const abs = import_node_path2.default.join(root, f.rel);
-  import_node_fs2.default.mkdirSync(import_node_path2.default.dirname(abs), { recursive: true });
-  import_node_fs2.default.writeFileSync(abs, f.content, "utf8");
-}
-function readLedger(file) {
-  try {
-    const j = JSON.parse(import_node_fs2.default.readFileSync(file, "utf8"));
-    return j && typeof j === "object" && j.blocks ? j : null;
-  } catch {
-    return null;
-  }
-}
-function ledgerContent(prev, target, entries, only) {
-  const blocks = { ...prev?.blocks ?? {} };
-  for (const [id, files] of entries) {
-    const old = blocks[id];
-    const recorded = { ...old?.files ?? {} };
-    for (const f of files) {
-      if (f.action === "skip") continue;
-      recorded[f.rel] = sha(f.content);
-    }
-    const comp = only.get(id);
-    let components;
-    if (!comp) components = "all";
-    else if (old?.components === "all") components = "all";
-    else components = [.../* @__PURE__ */ new Set([...old?.components ?? [], comp])].sort();
-    blocks[id] = { files: Object.fromEntries(Object.entries(recorded).sort(([a], [b]) => a.localeCompare(b))), components };
-  }
-  const sorted = Object.fromEntries(Object.entries(blocks).sort(([a], [b]) => a.localeCompare(b)));
-  const stack = prev?.stack ? { stack: prev.stack } : {};
-  return `${JSON.stringify({ sdkVersion: SDK_VERSION, target, ...stack, blocks: sorted }, null, 2)}
-`;
-}
-function ensureEnvExample(root, dryRun, out) {
-  const file = import_node_path2.default.join(root, ".env.local.example");
-  const current = import_node_fs2.default.existsSync(file) ? import_node_fs2.default.readFileSync(file, "utf8") : null;
-  if (current !== null && /^G8_API_KEY=/m.test(current)) {
-    out("keep .env.local.example  (G8_API_KEY already listed)");
-    return;
-  }
-  out(`${dryRun ? "would " : ""}${current === null ? "create" : "update"} .env.local.example  (+ G8_API_KEY=)`);
-  if (dryRun) return;
-  const base = current === null ? "" : current.endsWith("\n") || current === "" ? current : `${current}
-`;
-  import_node_fs2.default.writeFileSync(file, `${base}G8_API_KEY=
-`, "utf8");
-}
-function runAdd(opts, reg, io, cwd) {
-  const root = import_node_path2.default.resolve(cwd, opts.dir);
-  const pkg = readPkg(root);
-  if (!pkg) {
-    io.err(`no package.json in ${root}. Run this from your app's root, or pass --dir.`);
-    return 1;
-  }
-  let parsed;
-  let blocks;
-  try {
-    parsed = parseSpec(opts.spec);
-    blocks = resolveWithDeps(reg, [parsed.blockId]);
-    const main2 = blocks[blocks.length - 1];
-    if (parsed.component && !main2.components.some((c) => c.name === parsed.component)) {
-      const names = main2.components.map((c) => c.name).join(", ") || "none";
-      throw new Error(`block "${main2.id}" has no component "${parsed.component}" (available: ${names})`);
-    }
-  } catch (e) {
-    io.err(e.message);
-    return 1;
-  }
-  const exists = (p) => import_node_fs2.default.existsSync(import_node_path2.default.join(root, p));
-  const target = opts.target ?? (exists("src") && !exists("components") && !exists("app") ? "src/components/g8" : "components/g8");
-  const targetAbs = import_node_path2.default.resolve(root, target);
-  const isNext = Boolean(pkg.dependencies?.next ?? pkg.devDependencies?.next);
-  const dry = opts.dryRun;
-  const verb = (a) => a === "unchanged" ? "keep" : a === "skip" ? "skip" : dry ? `would ${a}` : a;
-  const entries = /* @__PURE__ */ new Map();
-  const only = /* @__PURE__ */ new Map();
-  const main = blocks[blocks.length - 1];
-  for (const b of blocks) {
-    const comp = b === main ? parsed.component : void 0;
-    only.set(b.id, comp);
-    entries.set(b.id, planBlock(b, comp, reg, targetAbs, root, opts.force));
-  }
-  const all = [...entries.values()].flat();
-  const route = planAppFiles(blocks, reg, targetAbs, root, isNext, opts.force);
-  io.out(`${dry ? "Dry run: " : ""}adding ${blocks.map((b) => b.id).join(" + ")} to ${target}`);
-  for (const f of [...all, ...route.files]) io.out(`${verb(f.action)} ${f.rel}${f.detail ? `  (${f.detail})` : ""}`);
-  if (route.note) route.note.forEach((l) => io.out(l));
-  if (!dry) {
-    for (const f of [...all, ...route.files]) if (f.action === "create" || f.action === "update") writeFile(root, f);
-  }
-  ensureEnvExample(root, dry, io.out);
-  const ledgerPath = import_node_path2.default.join(root, "graph8.json");
-  const next = ledgerContent(readLedger(ledgerPath), posix(import_node_path2.default.relative(root, targetAbs)), entries, only);
-  const prevText = import_node_fs2.default.existsSync(ledgerPath) ? import_node_fs2.default.readFileSync(ledgerPath, "utf8") : null;
-  if (next !== prevText) {
-    io.out(`${dry ? "would " : ""}${prevText === null ? "create" : "update"} graph8.json`);
-    if (!dry) import_node_fs2.default.writeFileSync(ledgerPath, next, "utf8");
-  } else io.out("keep graph8.json");
-  return installPeers(blocks, pkg, root, opts, io);
-}
-function installPeers(blocks, pkg, root, opts, io) {
-  const missing = missingPeers(blocks, pkg);
-  if (!missing.length) return 0;
-  const pm = detectPackageManager(root);
-  const { cmd, args } = installCommand(pm, missing);
-  const shown = `${cmd} ${args.join(" ")}`;
-  if (!opts.install || opts.dryRun) {
-    io.out(`${opts.dryRun ? "would run" : "not installing (--no-install). Run"}: ${shown}`);
-    return 0;
-  }
-  io.out(`installing peer dependencies: ${shown}`);
-  const code = io.spawn(cmd, args, root);
-  if (code !== 0) {
-    io.err(`peer dependency install failed (exit ${code}). Run it yourself: ${shown}`);
-    return 1;
-  }
-  return 0;
-}
-function appTargetPath(root, target) {
-  const useSrc = import_node_fs2.default.existsSync(import_node_path2.default.join(root, "src", "app")) && !import_node_fs2.default.existsSync(import_node_path2.default.join(root, "app"));
-  return useSrc && target.startsWith("app/") ? `src/${target}` : target;
-}
-function planAppFiles(blocks, reg, targetAbs, root, isNext, force) {
-  const files = [];
-  let skipped = false;
-  for (const b of blocks) {
-    for (const [file, target] of appTargeted(b)) {
-      if (!isNext) {
-        skipped = true;
-        continue;
-      }
-      const destAbs = import_node_path2.default.join(root, appTargetPath(root, target));
-      const src = import_node_path2.default.join(b.root, file);
-      const content = rewriteImports(import_node_fs2.default.readFileSync(src, "utf8"), { reg, targetAbs, destDir: import_node_path2.default.dirname(destAbs) });
-      files.push(classify(destAbs, posix(import_node_path2.default.relative(root, destAbs)), content, force));
-    }
-  }
-  return { files, note: skipped ? PROXY_CONTRACT : void 0 };
-}
-
-// src/blocks/create.ts
-var import_node_fs3 = __toESM(require("fs"));
-var import_node_path3 = __toESM(require("path"));
-var CREATE_USAGE = `Usage: npx @graph8/sdk create <stack> <dir> [options]
-
-Scaffold a Next.js (App Router, TypeScript, Tailwind CSS v4) app for a stack and
-install the stack's blocks into it. Run \`graph8-sdk list\` to see the stacks.
-  --package-manager <npm|pnpm|yarn|bun>   default: the one running the command, else npm
-  --no-install      write the files and blocks, do not install dependencies
-  --dry-run         print what would be written, write and install nothing
-  --force           allow a non-empty <dir> (template files are overwritten, and graph8.json
-                    is reset: blocks you added to that app earlier are no longer recorded)
-Then: set G8_API_KEY in <dir>/.env.local and run \`npx @graph8/sdk doctor --stack <stack>\`.`;
-var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
-function parseCreateArgs(argv) {
-  const o = { stack: "", dir: "", install: true, dryRun: false, force: false };
-  const positional = [];
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    const eq = arg.startsWith("--") ? arg.indexOf("=") : -1;
-    const [flag, inline] = eq > 0 ? [arg.slice(0, eq), arg.slice(eq + 1)] : [arg, void 0];
-    if (flag === "--package-manager") {
-      const v = inline ?? argv[++i];
-      if (!PACKAGE_MANAGERS.includes(v)) throw new Error(`--package-manager must be one of ${PACKAGE_MANAGERS.join(", ")}
-
-${CREATE_USAGE}`);
-      o.packageManager = v;
-    } else if (arg === "--no-install") o.install = false;
-    else if (arg === "--dry-run") o.dryRun = true;
-    else if (arg === "--force") o.force = true;
-    else if (arg.startsWith("-")) throw new Error(`unknown option ${arg}
-
-${CREATE_USAGE}`);
-    else positional.push(arg);
-  }
-  if (positional.length !== 2) throw new Error(`create needs a stack and a directory
-
-${CREATE_USAGE}`);
-  [o.stack, o.dir] = positional;
-  return o;
-}
-function packageManagerFromUserAgent(ua) {
-  const name = /^(npm|pnpm|yarn|bun)\//.exec(ua ?? "")?.[1];
-  return name ?? "npm";
-}
-function appNameFor(dir) {
-  const base = import_node_path3.default.basename(import_node_path3.default.resolve(dir)).toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^[._-]+|-+$/g, "");
-  return base || "g8-app";
-}
-function render(template, vars) {
-  return template.replace(/\{\{(\w+)\}\}/g, (_m, key) => {
-    if (!(key in vars)) throw new Error(`template placeholder {{${key}}} has no value`);
-    return vars[key];
-  });
-}
-var quoted = (p) => /^[\w@%+=:,./-]+$/.test(p) ? p : JSON.stringify(p);
-var posix2 = (p) => p.split(import_node_path3.default.sep).join("/");
-function walk(dir, base = dir) {
-  const out = [];
-  for (const e of import_node_fs3.default.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
-    const full = import_node_path3.default.join(dir, e.name);
-    if (e.isDirectory()) out.push(...walk(full, base));
-    else out.push(posix2(import_node_path3.default.relative(base, full)));
-  }
-  return out;
-}
-function outputName(rel) {
-  const noExt = rel.replace(/\.tmpl$/, "");
-  const dir = import_node_path3.default.posix.dirname(noExt);
-  const base = import_node_path3.default.posix.basename(noExt).replace(/^dot-/, ".");
-  return dir === "." ? base : `${dir}/${base}`;
-}
-function pageFileFor(navPath) {
-  const segs = navPath.split("/").filter(Boolean);
-  return ["app", ...segs, "page.tsx"].join("/");
-}
-function componentImportPath(block, file) {
-  const rel = installedRel(file) ?? file;
-  return `@/components/g8/${block.dir}/${rel.replace(/\.(tsx|ts|jsx|js)$/, "")}`;
-}
-function stackProblem(reg, stack) {
-  const { missing } = stackStatus(reg, stack);
-  if (missing.length) {
-    const ready = reg.stacks.filter((s) => !stackStatus(reg, s).missing.length).map((s) => s.id);
-    return [
-      `stack "${stack.id}" is planned: these blocks are not in this version of @graph8/sdk yet: ${missing.join(", ")}.`,
-      `Stacks you can create now: ${ready.join(", ") || "none"}. Or create one of those and add blocks as they ship (\`graph8-sdk add <block>\`).`
-    ].join("\n");
-  }
-  const seen = /* @__PURE__ */ new Set();
-  for (const n of stack.nav) {
-    const block = findBlock(reg, n.block);
-    if (!stack.blocks.includes(n.block)) return `stack "${stack.id}" nav "${n.label}" uses block "${n.block}" which the stack does not include.`;
-    if (!block?.components.some((c) => c.name === n.component)) return `stack "${stack.id}" nav "${n.label}" uses ${n.component}, which block "${n.block}" does not declare.`;
-    if (/[\[\]]/.test(n.path)) return `stack "${stack.id}" nav "${n.label}" uses ${n.path}: dynamic segments cannot be a sidebar link.`;
-    if (seen.has(n.path)) return `stack "${stack.id}" has two nav entries at ${n.path}.`;
-    seen.add(n.path);
-  }
-  return null;
-}
-function renderPages(reg, stack, templates) {
-  const pageTpl = import_node_fs3.default.readFileSync(import_node_path3.default.join(templates, "_pages", "route-page.tsx.tmpl"), "utf8");
-  const files = stack.nav.map((n) => {
-    const block = findBlock(reg, n.block);
-    const comp = block.components.find((c) => c.name === n.component);
-    const content = render(pageTpl, {
-      stackId: stack.id,
-      block: block.id,
-      blockDir: `components/g8/${block.dir}`,
-      component: n.component,
-      importPath: componentImportPath(block, comp.file),
-      propsJson: JSON.stringify(n.props ?? {}, null, 2)
-    });
-    return { rel: pageFileFor(n.path), content };
-  });
-  if (stack.nav.length && !stack.nav.some((n) => n.path === "/")) {
-    const redirect = import_node_fs3.default.readFileSync(import_node_path3.default.join(templates, "_pages", "redirect-page.tsx.tmpl"), "utf8");
-    files.push({ rel: "app/page.tsx", content: render(redirect, { firstPathJson: JSON.stringify(stack.nav[0].path) }) });
-  }
-  return files;
-}
-function peerDependenciesFor(blocks, io) {
-  const peers = {};
-  for (const b of blocks) for (const [name, range] of Object.entries(b.peerDependencies)) peers[name] ??= range;
-  const usesUi = blocks.some((b) => walk(b.root).some((f) => /\.(tsx?|jsx?)$/.test(f) && /["']@graph8\/sdk\/ui["'/]/.test(import_node_fs3.default.readFileSync(import_node_path3.default.join(b.root, f), "utf8"))));
-  if (usesUi && io.sdkPackageJson && import_node_fs3.default.existsSync(io.sdkPackageJson)) {
-    const sdk = JSON.parse(import_node_fs3.default.readFileSync(io.sdkPackageJson, "utf8"));
-    for (const [name, range] of Object.entries(sdk.peerDependencies ?? {})) peers[name] ??= range;
-  }
-  return peers;
-}
-function mergedPackageJson(rendered, peers) {
-  const pkg = JSON.parse(rendered);
-  for (const [name, range] of Object.entries(peers)) pkg.dependencies[name] ??= range;
-  pkg.dependencies = Object.fromEntries(Object.entries(pkg.dependencies).sort(([a], [b]) => a.localeCompare(b)));
-  return `${JSON.stringify(pkg, null, 2)}
-`;
-}
-function planCreate(reg, stack, appName, pm, io) {
-  const templates = import_node_path3.default.join(io.templatesRoot, "next-app");
-  const blocks = resolveWithDeps(reg, stack.blocks);
-  const devCommand = pm === "npm" ? "npm run dev" : `${pm} dev`;
-  const vars = {
-    appName,
-    sdkVersion: SDK_VERSION,
-    stackId: stack.id,
-    title: stack.title,
-    titleJson: JSON.stringify(stack.title),
-    navJson: JSON.stringify(stack.nav.map((n) => ({ label: n.label, path: n.path })), null, 2),
-    devCommand,
-    screens: stack.nav.map((n) => `- ${n.label}: \`${n.path}\` (${n.block} block, \`${n.component}\`)`).join("\n") || "- (none yet: add a block with `npx @graph8/sdk add <block>`)"
-  };
-  const files = [];
-  for (const rel of walk(templates).filter((f) => !f.startsWith("_pages/"))) {
-    let content = render(import_node_fs3.default.readFileSync(import_node_path3.default.join(templates, rel), "utf8"), vars);
-    if (rel === "package.json.tmpl") content = mergedPackageJson(content, peerDependenciesFor(blocks, io));
-    files.push({ rel: outputName(rel), content });
-  }
-  files.push(...renderPages(reg, stack, templates));
-  const ledger = { sdkVersion: SDK_VERSION, target: "components/g8", stack: stack.id, blocks: {} };
-  files.push({ rel: "graph8.json", content: `${JSON.stringify(ledger, null, 2)}
-` });
-  return files;
-}
-function dirProblem(abs, force) {
-  if (!import_node_fs3.default.existsSync(abs)) return null;
-  if (!import_node_fs3.default.statSync(abs).isDirectory()) return `${abs} exists and is not a directory.`;
-  if (force || import_node_fs3.default.readdirSync(abs).length === 0) return null;
-  return `${abs} is not empty. Pick a new directory, or pass --force to write into it (template files are overwritten).`;
-}
-function runCreate(opts, reg, io, cwd) {
-  const stack = reg.stacks.find((s) => s.id === opts.stack);
-  if (!stack) {
-    io.err(`unknown stack "${opts.stack}". Stacks: ${reg.stacks.map((s) => s.id).join(", ") || "none"} (\`graph8-sdk list\`).`);
-    return 1;
-  }
-  const problem = stackProblem(reg, stack);
-  if (problem) return io.err(problem), 1;
-  const abs = import_node_path3.default.resolve(cwd, opts.dir);
-  const dirIssue = dirProblem(abs, opts.force);
-  if (dirIssue) return io.err(dirIssue), 1;
-  const pm = opts.packageManager ?? packageManagerFromUserAgent(io.userAgent);
-  let files;
-  try {
-    files = planCreate(reg, stack, appNameFor(opts.dir), pm, io);
-  } catch (e) {
-    io.err(e.message);
-    return 1;
-  }
-  const blocks = resolveWithDeps(reg, stack.blocks);
-  io.out(`${opts.dryRun ? "Dry run: " : ""}creating "${stack.title}" (${stack.id}) in ${opts.dir}`);
-  for (const f of files) io.out(`${opts.dryRun ? "would write" : "write"} ${f.rel}`);
-  if (opts.dryRun) {
-    io.out(`would add blocks: ${blocks.map((b) => b.id).join(", ")}`);
-    io.out(opts.install ? `would run: ${pm} install` : "would not install dependencies (--no-install)");
-    return 0;
-  }
-  for (const f of files) {
-    const dest = import_node_path3.default.join(abs, f.rel);
-    import_node_fs3.default.mkdirSync(import_node_path3.default.dirname(dest), { recursive: true });
-    import_node_fs3.default.writeFileSync(dest, f.content, "utf8");
-  }
-  return finish(opts, reg, stack, blocks, abs, pm, io, cwd);
-}
-function finish(opts, reg, stack, blocks, abs, pm, io, cwd) {
-  for (const b of blocks) {
-    const code = runAdd({ spec: b.id, dir: abs, target: "components/g8", dryRun: false, force: opts.force, install: false }, reg, io, cwd);
-    if (code !== 0) {
-      io.err(`adding block "${b.id}" failed; the app in ${opts.dir} is incomplete.`);
-      return code;
-    }
-  }
-  if (opts.install) {
-    io.out(`installing dependencies: ${pm} install`);
-    const code = io.spawn(pm, ["install"], abs);
-    if (code !== 0) {
-      io.err(`dependency install failed (exit ${code}). Run it yourself: cd ${quoted(opts.dir)} && ${pm} install`);
-      return 1;
-    }
-  }
-  const cd = opts.dir === "." ? "" : `cd ${quoted(opts.dir)} && `;
-  io.out(
-    [
-      "",
-      `Done. Next:`,
-      `  1. set G8_API_KEY in ${import_node_path3.default.posix.join(opts.dir, ".env.local")} (copy .env.local.example)`,
-      `  2. ${cd}npx @graph8/sdk doctor --stack ${stack.id}`,
-      `  3. ${cd}${opts.install ? "" : `${pm} install && `}${pm === "npm" ? "npm run dev" : `${pm} dev`}`
-    ].join("\n")
-  );
-  return 0;
-}
-
-// src/blocks/doctor.ts
-var import_node_fs4 = __toESM(require("fs"));
-var import_node_path4 = __toESM(require("path"));
-
-// src/generated/billable.ts
-var BILLABLE_ROUTES = {
-  GET: [
-    "/apps/{app_id}/runtime",
-    "/audience-syncs/{config_id}/runs",
-    "/campaigns/{campaign_id}/dashboard",
-    "/companies/{company_id}/next-best-step",
-    "/contacts/{contact_id}/next-best-step",
-    "/desk/kickoff",
-    "/desk/kickoff/audio",
-    "/radar/competitors/{competitor_id}/discover-pages",
-    "/repos/{repo_id}/scan",
-    "/seo/domains/{domain}/backlinks",
-    "/seo/domains/{domain}/overview",
-    "/voice/campaigns/call-scripts",
-    "/voice/campaigns/email-templates",
-    "/voice/campaigns/templates",
-    "/voice/research/business-data",
-    "/voice/research/competitors",
-    "/voice/research/faq",
-    "/voice/research/keywords",
-    "/voice/research/prospect-company",
-    "/work/routines/{routine_id}/runs"
-  ],
-  PATCH: [
-    "/enrichment/auto-enrichment/configs/{config_id}",
-    "/intent/keywords/{keyword_id}",
-    "/intent/keywords/{keyword_id}/sync-config",
-    "/marketplace/agencies/{slug}",
-    "/marketplace/agencies/{slug}/reps/{sdr_id}",
-    "/marketplace/agencies/{slug}/service-statements/{statement_id}",
-    "/marketplace/applications/{application_id}",
-    "/marketplace/conversations/{conversation_id}/state",
-    "/marketplace/job-posts/{post_id}",
-    "/marketplace/me/meetings/{meeting_id}",
-    "/marketplace/me/messages/{conversation_id}/state",
-    "/marketplace/me/profile",
-    "/marketplace/me/service-statements/{statement_id}",
-    "/marketplace/org/meetings/{meeting_id}",
-    "/radar/competitors/{competitor_id}",
-    "/radar/gaps/{gap_id}",
-    "/research-reports/{report_id}",
-    "/social-listeners/settings",
-    "/social-listeners/{listener_id}"
-  ],
-  POST: [
-    "/accounts/{account_id}/generate-outreach-plan",
-    "/accounts/{account_id}/security-questionnaires",
-    "/accounts/{account_id}/stakeholders/{stakeholder_id}/generate-outreach",
-    "/ad-creatives",
-    "/ad-creatives/batch",
-    "/ad-creatives/concepts",
-    "/ad-creatives/video/clips",
-    "/ad-creatives/video/clips/prompt-enhance",
-    "/ad-creatives/video/clips/{clip_id}/continue",
-    "/ad-creatives/video/clips/{clip_id}/extend",
-    "/ad-creatives/video/clips/{clip_id}/regenerate",
-    "/ad-creatives/{creative_id}/ai-review",
-    "/ad-creatives/{creative_id}/chat-edit",
-    "/ad-creatives/{creative_id}/image-edit-at-point",
-    "/ad-creatives/{creative_id}/persona-lens",
-    "/ad-creatives/{creative_id}/regenerate-copy",
-    "/ad-creatives/{creative_id}/regenerate-image",
-    "/ad-creatives/{creative_id}/retry",
-    "/ad-creatives/{creative_id}/rewrite-field",
-    "/ad-creatives/{creative_id}/size-set",
-    "/agent/chat",
-    "/agent/onboarding/discovery/turn",
-    "/agent/operators/{operator}/approvals/{task_id}/decide",
-    "/agent/sessions/{session_id}/voice",
-    "/agent/work-items",
-    "/app-pages/{page_id}/generate",
-    "/campaigns/generate-ideas",
-    "/campaigns/generate-ideas-async",
-    "/campaigns/recommend-personas",
-    "/campaigns/{campaign_id}/audience-pipeline/accept-filters",
-    "/campaigns/{campaign_id}/audience-pipeline/trigger",
-    "/campaigns/{campaign_id}/documents/{document_id}/regenerate",
-    "/campaigns/{campaign_id}/sequence/steps/{step_id}/generate",
-    "/companies/enrich/bulk",
-    "/companies/enrich/people/bulk",
-    "/companies/enrich/stakeholders/bulk",
-    "/companies/import",
-    "/companies/{company_id}/documents/types/{doc_type}/generate",
-    "/companies/{company_id}/documents/types/{doc_type}/regenerate",
-    "/companies/{company_id}/enrich",
-    "/companies/{company_id}/retry-intelligence",
-    "/companies/{company_id}/retry-synthesis",
-    "/companies/{company_id}/workflows/{workflow_type}/start",
-    "/company-profile/generate",
-    "/company-profile/reindex",
-    "/company-profile/retry",
-    "/contacts/unlock-info",
-    "/contacts/verify-email",
-    "/contacts/verify-email/async",
-    "/contacts/workflow-executions/run",
-    "/contacts/{contact_id}/documents/generate-all",
-    "/contacts/{contact_id}/documents/types/{doc_type}/generate",
-    "/contacts/{contact_id}/documents/types/{doc_type}/regenerate",
-    "/content-workspace/import/crawl",
-    "/content/calendar/ideas/{idea_id}/create-content",
-    "/content/calendar/mine-signals",
-    "/content/calendar/repurpose/ad",
-    "/content/calendar/repurpose/linkedin-post",
-    "/content/grids/{grid_id}/columns/{column_id}/run",
-    "/content/grids/{grid_id}/rows/{row_id}/run/{column_id}",
-    "/content/pages/enrich-seo-bulk",
-    "/content/pages/{page_id}/enrich-seo",
-    "/copilot/chat",
-    "/copilot/landing-page-action",
-    "/copilot/memory/promote",
-    "/customer-success/companies/{company_id}/brief/synthesize",
-    "/deals/{deal_id}/documents/generate-all",
-    "/deals/{deal_id}/documents/types/{doc_type}/generate",
-    "/deals/{deal_id}/documents/types/{doc_type}/regenerate",
-    "/deals/{deal_id}/next-best-step",
-    "/desk/accounts/{account_id}/committee/{contact_id}/find-linkedin",
-    "/desk/accounts/{account_id}/plan/draft",
-    "/desk/ask",
-    "/desk/decisions/{decision_id}/replan",
-    "/desk/email-improve",
-    "/desk/email-score",
-    "/desk/org-settings/plan-stages/run",
-    "/desk/voice-memo",
-    "/dialer/parallel-calls/grading/backfill",
-    "/dialer/sessions/prewarm-voicemails",
-    "/enrichment/ai-formula/generate",
-    "/enrichment/ai-formula/generate-condition",
-    "/enrichment/ai/batch/enrich",
-    "/enrichment/ai/enrich",
-    "/enrichment/ai/qualification/generate-templates",
-    "/enrichment/ai/qualification/run",
-    "/enrichment/auto-enrichment/configs",
-    "/enrichment/enrich",
-    "/enrichment/find-people/configure",
-    "/enrichment/find-people/search-import",
-    "/enrichment/find-people/{config_id}/import",
-    "/enrichment/find-people/{config_id}/preview",
-    "/enrichment/find-people/{config_id}/run",
-    "/enrichment/generate-prompt",
-    "/enrichment/jobs/{job_id}/resume",
-    "/enrichment/list-routing/generate-filter",
-    "/enrichment/lists/{list_id}/pipelines",
-    "/enrichment/lists/{list_id}/pipelines/ai-draft",
-    "/enrichment/lists/{list_id}/pipelines/{pipeline_id}/enabled",
-    "/enrichment/lists/{list_id}/pipelines/{pipeline_id}/runs",
-    "/enrichment/lookup/company",
-    "/enrichment/lookup/person",
-    "/enrichment/person",
-    "/enrichment/record-sync/{entity_type}/run",
-    "/enrichment/verify-email",
-    "/enrichment/waterfall/configs",
-    "/enrichment/waterfall/enrich",
-    "/global-context/generate-all",
-    "/global-context/generate/{doc_type}",
-    "/hiring-signals/aggregators",
-    "/hiring-signals/companies",
-    "/hiring-signals/companies/job-counts",
-    "/hiring-signals/companies/resolve-ids",
-    "/hiring-signals/decision-makers",
-    "/hiring-signals/job-changes/match",
-    "/hiring-signals/jobs",
-    "/hiring-signals/recruiters",
-    "/icps/generate",
-    "/inbox/drafts/generate",
-    "/intelligence/analyze",
-    "/intelligence/retry",
-    "/intent/contacts/metadata",
-    "/intent/keywords/add",
-    "/intent/keywords/auto-seed-proposals",
-    "/intent/keywords/create-from-domain",
-    "/intent/keywords/create-from-search",
-    "/intent/keywords/list",
-    "/intent/keywords/{keyword_id}/companies",
-    "/intent/keywords/{keyword_id}/contacts",
-    "/intent/keywords/{keyword_id}/filters",
-    "/intent/keywords/{keyword_id}/job-resolution",
-    "/intent/keywords/{keyword_id}/sync",
-    "/intent/keywords/{keyword_id}/urls",
-    "/intent/pages-by-domain",
-    "/intent/pages/contacts",
-    "/intent/pages/search",
-    "/intent/pages/visitor-counts",
-    "/intent/pages/visitors",
-    "/landing-pages",
-    "/landing-pages/clone-homepage",
-    "/landing-pages/clone-html",
-    "/landing-pages/clone-url",
-    "/landing-pages/components/extract",
-    "/landing-pages/ensure-base-template",
-    "/landing-pages/{landing_page_id}/ai-review",
-    "/landing-pages/{landing_page_id}/ai-review/fix-with-ai",
-    "/landing-pages/{landing_page_id}/edit",
-    "/landing-pages/{landing_page_id}/edit-element",
-    "/landing-pages/{landing_page_id}/edit-page",
-    "/landing-pages/{landing_page_id}/generate-seo-metadata",
-    "/landing-pages/{landing_page_id}/rewrite-text",
-    "/leads/generate-content/batches",
-    "/leads/{lead_id}/generate-content",
-    "/library/case-studies/backfill",
-    "/lifecycle-contacts/unlock",
-    "/mailboxes/schedule-buy/plans",
-    "/mailboxes/schedule-buy/plans/{plan_id}/resume",
-    "/mailboxes/uncancel",
-    "/mailboxes/{mailbox_id}/health/placement-test",
-    "/marketplace/agencies/{slug}/intake/upload",
-    "/marketplace/agencies/{slug}/reps/{sdr_id}/unlist",
-    "/marketplace/agencies/{slug}/reps/{sdr_id}/video-intro",
-    "/marketplace/agencies/{slug}/service-statements",
-    "/marketplace/agencies/{slug}/service-statements/{statement_id}/line-items",
-    "/marketplace/agencies/{slug}/service-statements/{statement_id}/submit",
-    "/marketplace/commissions/entries",
-    "/marketplace/commissions/entries/{entry_id}/quality",
-    "/marketplace/commissions/entries/{entry_id}/reversals",
-    "/marketplace/commissions/entries/{entry_id}/statement",
-    "/marketplace/commissions/plans",
-    "/marketplace/commissions/plans/{version_id}/activate",
-    "/marketplace/commissions/preview",
-    "/marketplace/conversations/{conversation_id}/read",
-    "/marketplace/job-posts",
-    "/marketplace/job-posts/{post_id}/jd",
-    "/marketplace/me/headshot",
-    "/marketplace/me/invoices",
-    "/marketplace/me/invoices/{invoice_id}/approve",
-    "/marketplace/me/messages/{conversation_id}/read",
-    "/marketplace/me/offers/{hiring_id}/accept",
-    "/marketplace/me/offers/{hiring_id}/reject",
-    "/marketplace/me/payout-account/w8-certify",
-    "/marketplace/me/resume",
-    "/marketplace/me/service-statements",
-    "/marketplace/me/service-statements/{statement_id}/line-items",
-    "/marketplace/me/service-statements/{statement_id}/revise",
-    "/marketplace/me/service-statements/{statement_id}/submit",
-    "/marketplace/me/video-intro",
-    "/marketplace/me/work-certificates",
-    "/marketplace/opportunities/{post_id}/apply",
-    "/marketplace/org/hirings/{hiring_id}/meetings",
-    "/marketplace/org/hirings/{hiring_id}/terminate",
-    "/marketplace/org/hirings/{hiring_id}/withdraw",
-    "/marketplace/org/invoices/{invoice_id}/approve",
-    "/marketplace/org/invoices/{invoice_id}/dispute",
-    "/marketplace/org/service-statements/{statement_id}/approve",
-    "/marketplace/org/service-statements/{statement_id}/line-items",
-    "/marketplace/org/service-statements/{statement_id}/reject",
-    "/marketplace/org/service-statements/{statement_id}/request-changes",
-    "/marketplace/shortlist/export",
-    "/marketplace/talent/{sdr_id}/hire",
-    "/marketplace/talent/{sdr_id}/match/analyze",
-    "/marketplace/talent/{sdr_id}/match/refresh",
-    "/marketplace/terms-acknowledgements/ack-all",
-    "/meeting-transcripts/{transcript_id}/follow-up-draft",
-    "/meeting-transcripts/{transcript_id}/review/regenerate",
-    "/newsletters/templates/clone",
-    "/newsletters/templates/custom",
-    "/newsletters/templates/layout",
-    "/newsletters/{newsletter_id}/issues/{issue_id}/generate",
-    "/newsletters/{newsletter_id}/issues/{issue_id}/rewrite-text",
-    "/newsletters/{newsletter_id}/subscribers/import-audience",
-    "/newsletters/{newsletter_id}/subscribers/verify",
-    "/org-videos/generate",
-    "/org/brand-snapshot/refresh",
-    "/personas/generate",
-    "/phone-numbers/purchase",
-    "/pipelines/suggest",
-    "/placement/tests",
-    "/provider-domains/add-external",
-    "/provider-domains/check-availability",
-    "/provider-domains/checkout-purchase",
-    "/provider-domains/checkout-transfer",
-    "/provider-domains/{domain_id}/auto-warmup",
-    "/provider-domains/{domain_id}/check-propagation",
-    "/provider-domains/{domain_id}/checkout-mailboxes",
-    "/provider-domains/{domain_id}/connect-provider",
-    "/provider-domains/{domain_id}/dns",
-    "/public/enrich/lookup",
-    "/radar/aeo/run",
-    "/radar/competitors",
-    "/radar/competitors/bulk",
-    "/radar/competitors/{competitor_id}/scan",
-    "/radar/gaps/analyze",
-    "/radar/initiatives/measure",
-    "/radar/opportunities/approve-all",
-    "/radar/opportunities/{gap_id}/approve",
-    "/radar/reports",
-    "/radar/scan-all",
-    "/repos/{repo_id}/scan",
-    "/research-reports/generate",
-    "/research-reports/generate-all",
-    "/research-reports/retry",
-    "/research-reports/workflow/resume",
-    "/revenue/stage-docs/{lifecycle_entry_id}/{entity}/backfill",
-    "/scrape/requests",
-    "/search/companies",
-    "/search/companies/save",
-    "/search/contacts",
-    "/search/contacts/save",
-    "/seo/audits",
-    "/seo/keywords/research",
-    "/sequencer/content/email/generate",
-    "/sequencer/content/instructions/improve",
-    "/sequencer/content/linkedin/generate",
-    "/sequencer/templates/steps/generate",
-    "/social-listeners",
-    "/social-listeners/auto-seed/all",
-    "/social-listeners/auto-seed/brand",
-    "/social-listeners/auto-seed/competitors",
-    "/social-listeners/auto-seed/engagement",
-    "/social-listeners/auto-seed/keywords",
-    "/social-listeners/bulk-from-list",
-    "/social-listeners/integrations/x",
-    "/social-listeners/integrations/x/test",
-    "/social-listeners/posts/{post_id}/engagements/add-to-list",
-    "/social-listeners/posts/{post_id}/mark",
-    "/social-listeners/posts/{post_id}/save-contact",
-    "/social-listeners/queries/generate",
-    "/social/posts/generate",
-    "/tam/generate",
-    "/tam/regenerate",
-    "/tasks/{task_id}/start",
-    "/team-members/me/enrich-linkedin",
-    "/team-members/{team_member_id}/enrich-linkedin",
-    "/team-members/{team_member_id}/generate-post",
-    "/teams/auto-compose/suggest",
-    "/voice/agents/{agent_id}/documents/upload",
-    "/voice/call-flow-examples/transcribe",
-    "/voice/call-scripts/generate",
-    "/voice/campaigns/call-scripts",
-    "/voice/campaigns/email-enhancements",
-    "/voice/campaigns/email-spintax",
-    "/voice/campaigns/emails",
-    "/voice/campaigns/linkedin-messages",
-    "/voice/campaigns/onboarding/messages",
-    "/voice/campaigns/onboarding/threads/actions",
-    "/voice/campaigns/voicemails",
-    "/voice/chat-agent/messages",
-    "/voice/collections/{collection_id}/files/paste-text",
-    "/voice/collections/{collection_id}/files/upload",
-    "/voice/collections/{collection_id}/files/upload-multiple",
-    "/voice/collections/{collection_id}/reindex",
-    "/voice/collections/{collection_id}/scrape-sources",
-    "/voice/collections/{collection_id}/scrape-sources/{source_id}/run",
-    "/voice/email-agent/batch",
-    "/voice/email-agent/compose",
-    "/voice/email-agent/draft-reply",
-    "/voice/icp/queries",
-    "/voice/knowledge-base/files/upload",
-    "/voice/receptionist/messages",
-    "/voice/research/company",
-    "/voice/research/org-chart",
-    "/voice/research/prospect-data",
-    "/voice/research/prospect-profile",
-    "/voice/topics/classify",
-    "/voice/twins",
-    "/voice/twins/extract-linkedin",
-    "/voice/video-recordings/upload",
-    "/voice/voice-library/onboarding-voice",
-    "/voice/voice-library/voices",
-    "/voice/worksheets/calculate",
-    "/work/signals/promote",
-    "/workbench/tables/{table_id}/ai/generate-prompt",
-    "/workbench/tables/{table_id}/ai/groups/{group_id}/run",
-    "/workbench/tables/{table_id}/ai/preview",
-    "/workbench/tables/{table_id}/ai/run",
-    "/workbench/tables/{table_id}/ai/run-all",
-    "/workbench/tables/{table_id}/columns/{col_id}/ai/run",
-    "/workbench/tables/{table_id}/find-people/configure",
-    "/workbench/tables/{table_id}/find-people/{config_id}/run",
-    "/workbench/tables/{table_id}/import/search",
-    "/workbench/tables/{table_id}/import/search/research/preview",
-    "/workbench/tables/{table_id}/pipelines",
-    "/workbench/tables/{table_id}/scraper/providers/{provider}/runs",
-    "/workbench/tables/{table_id}/scraper/runs",
-    "/workbench/tables/{table_id}/suggest-mappings",
-    "/workbench/tables/{table_id}/triggers",
-    "/workbench/tables/{table_id}/unlock-rows",
-    "/workbench/tables/{table_id}/waterfall/configs/{column_id}/run"
-  ],
-  PUT: [
-    "/agent/operators/{operator}/enabled",
-    "/agent/operators/{operator}/skills/{skill_key}",
-    "/deliverability/autopilot/preferences",
-    "/enrichment/auto-enrichment/settings/{entity_type}",
-    "/enrichment/lists/{list_id}/pipelines/{pipeline_id}",
-    "/enrichment/record-sync/{entity_type}/policy",
-    "/enrichment/waterfall/configs/{column_id}",
-    "/marketplace/me/invoices/{invoice_id}",
-    "/marketplace/me/rates",
-    "/radar/settings",
-    "/workbench/tables/{table_id}/auto-enrich",
-    "/workbench/tables/{table_id}/pipelines/{pipeline_id}",
-    "/workbench/tables/{table_id}/schedule",
-    "/workbench/tables/{table_id}/triggers/{trigger_id}"
-  ]
-};
-
-// src/generated/external.ts
-var EXTERNAL_ROUTES = {
-  GET: [
-    "/dialer/sessions/token",
-    "/marketplace/me/connect/dashboard-link",
-    "/marketplace/me/connect/onboarding-link",
-    "/marketplace/me/payout-account/login-link",
-    "/marketplace/me/payout-account/onboarding-link",
-    "/voice/mcp-servers/{mcp_server_id}/tools"
-  ],
-  PATCH: [
-    "/ad-campaigns/{campaign_id}/ads/{ad_id}",
-    "/appointments/bookings/{booking_uid}/location",
-    "/appointments/bookings/{booking_uid}/sequence",
-    "/appointments/workflows/{workflow_id}",
-    "/audience-syncs/{config_id}",
-    "/campaigns/{campaign_id}",
-    "/campaigns/{campaign_id}/full",
-    "/content/calendar/{content_type}/{content_id}/schedule",
-    "/inbox/mailboxes/bulk",
-    "/inbox/mailboxes/{mailbox}/settings",
-    "/integrations/crm/meetings/{event_id}",
-    "/newsletters/{newsletter_id}/subscribers/{subscriber_id}/unsubscribe",
-    "/quotes/{quote_id}",
-    "/sequences/{sequence_id}",
-    "/sequences/{sequence_id}/steps/{step_id}",
-    "/voice/dialer/sessions/{session_id}/status",
-    "/voice/dispositions/{disposition_id}",
-    "/webhooks/{webhook_id}"
-  ],
-  POST: [
-    "/ad-campaigns/images",
-    "/ad-campaigns/status-refresh",
-    "/ad-campaigns/{campaign_id}/ads",
-    "/ad-campaigns/{campaign_id}/ads/batch",
-    "/ad-campaigns/{campaign_id}/ads/{ad_id}/status",
-    "/ad-campaigns/{campaign_id}/edit-preview",
-    "/ad-campaigns/{campaign_id}/retry",
-    "/ad-campaigns/{campaign_id}/status-refresh",
-    "/appointments/bookings",
-    "/appointments/bookings/import",
-    "/appointments/bookings/{booking_uid}/confirm",
-    "/appointments/bookings/{booking_uid}/guests",
-    "/appointments/bookings/{booking_uid}/mark-absent",
-    "/appointments/bookings/{booking_uid}/notes",
-    "/appointments/bookings/{booking_uid}/request-reschedule",
-    "/appointments/bookings/{booking_uid}/reschedule",
-    "/appointments/calendars/selected",
-    "/appointments/conferencing/connect/{provider}",
-    "/appointments/conferencing/{provider}/default",
-    "/appointments/workflows",
-    "/appointments/workflows/{workflow_id}/toggle",
-    "/audience-syncs",
-    "/audience-syncs/google/conversion-actions",
-    "/audience-syncs/google/conversions",
-    "/audience-syncs/google/video-assets/library",
-    "/audience-syncs/google/video-assets/links",
-    "/audience-syncs/google/video-assets/upload-urls",
-    "/audience-syncs/google/video-assets/uploads",
-    "/audience-syncs/{config_id}/launch",
-    "/audience-syncs/{config_id}/trigger",
-    "/campaigns",
-    "/campaigns/{campaign_id}/ad-images/{image_id}/hide",
-    "/campaigns/{campaign_id}/documents",
-    "/campaigns/{campaign_id}/launch",
-    "/campaigns/{campaign_id}/sequence/steps",
-    "/content/calendar/{content_type}/{content_id}/retry-publish",
-    "/crm-syncs/{provider}/companies/push",
-    "/crm-syncs/{provider}/contacts/push",
-    "/crm-syncs/{provider}/lists/push",
-    "/customer-success/companies/{company_id}/sync",
-    "/desk/accounts/{account_id}/committee/plays/{action_id}/run",
-    "/desk/accounts/{account_id}/committee/{contact_id}/linkedin-invite",
-    "/desk/decisions/{decision_id}/plays/{action_id}/run",
-    "/desk/decisions/{decision_id}/send-reply",
-    "/desk/decisions/{decision_id}/send-sms",
-    "/desk/plays/approvals/{execution_id}/decide",
-    "/dialer/parallel-calls/calls/{livekit_room_name}/drop-voicemail",
-    "/dialer/parallel-calls/manual-dial",
-    "/dialer/parallel-calls/redial-contact",
-    "/dialer/parallel-calls/sessions/start",
-    "/dialer/sessions/calls/drop-voicemail",
-    "/dialer/sessions/{session_id}/next-batch",
-    "/envelopes/{envelope_id}/resend",
-    "/envelopes/{envelope_id}/send",
-    "/feedback/sending-domains/verify",
-    "/feedback/surveys/{survey_id}/send",
-    "/forms/deliveries/{receipt_id}/retry",
-    "/forms/{form_key}/backfills",
-    "/forms/{form_key}/delivery/pause",
-    "/forms/{form_key}/delivery/resume",
-    "/inbox/emails/compose",
-    "/inbox/emails/{email_id}/send",
-    "/inbox/linkedin/accounts/sync",
-    "/inbox/linkedin/accounts/{account_id}/enable",
-    "/inbox/linkedin/compose",
-    "/inbox/mailboxes/activate",
-    "/inbox/mailboxes/{mailbox}/sync",
-    "/inbox/sms/compose",
-    "/inbox/{reply_id}/assign",
-    "/inbox/{reply_id}/send",
-    "/inbox/{reply_id}/tag",
-    "/integrations/connections",
-    "/integrations/connections/session-token",
-    "/integrations/crm-sync/audiences",
-    "/integrations/crm-sync/contacts/pull",
-    "/integrations/crm-sync/contacts/push",
-    "/integrations/crm-sync/deals/pull",
-    "/integrations/crm-sync/deals/push",
-    "/integrations/crm-sync/leads/previews",
-    "/integrations/crm-sync/leads/pull",
-    "/integrations/crm-sync/leads/push",
-    "/integrations/crm-sync/pull",
-    "/integrations/crm-sync/push",
-    "/integrations/crm/connections/{connection_id}/batch/contacts",
-    "/integrations/crm/connections/{connection_id}/companies",
-    "/integrations/crm/connections/{connection_id}/contacts",
-    "/integrations/crm/connections/{connection_id}/deals",
-    "/integrations/crm/connections/{connection_id}/leads",
-    "/integrations/crm/lists",
-    "/integrations/crm/lists/memberships",
-    "/integrations/crm/meetings",
-    "/integrations/linkedin-outreach/campaigns/{campaign_id}/pause",
-    "/integrations/linkedin-outreach/campaigns/{campaign_id}/resume",
-    "/integrations/linkedin-outreach/connection/reconnect",
-    "/integrations/linkedin-outreach/lists",
-    "/integrations/linkedin-outreach/lists/{list_id}/leads",
-    "/integrations/linkedin-outreach/workspaces/sync",
-    "/integrations/migrations/delta-sync",
-    "/integrations/migrations/discovery",
-    "/integrations/migrations/{migration_id}/confirm",
-    "/integrations/sugarcrm/connect",
-    "/integrations/sugarcrm/reconnect",
-    "/landing-pages/{landing_page_id}/publish",
-    "/landing-pages/{landing_page_id}/unpublish",
-    "/linkedin/accounts/sync",
-    "/marketplace/agencies/{slug}/reps/{sdr_id}/publish",
-    "/marketplace/me/messages/{conversation_id}/reply",
-    "/marketplace/me/payout-account/bank-details",
-    "/marketplace/me/payout-account/methods",
-    "/marketplace/me/payout-account/setup",
-    "/marketplace/me/sync-workbench",
-    "/marketplace/talent/{sdr_id}/messages",
-    "/marketplace/talent/{sdr_id}/request",
-    "/newsletters",
-    "/newsletters/{newsletter_id}/activate",
-    "/newsletters/{newsletter_id}/issues",
-    "/newsletters/{newsletter_id}/issues/{issue_id}/duplicate",
-    "/newsletters/{newsletter_id}/issues/{issue_id}/send",
-    "/newsletters/{newsletter_id}/issues/{issue_id}/send-test",
-    "/newsletters/{newsletter_id}/issues/{issue_id}/send/resume",
-    "/newsletters/{newsletter_id}/resume",
-    "/newsletters/{newsletter_id}/settings/verify-domain",
-    "/newsletters/{newsletter_id}/subscribers",
-    "/nurtures/{nurture_id}/launch",
-    "/org/sso/sync",
-    "/phone-numbers/a2p/register",
-    "/profile/deal-automations/sync-now",
-    "/programmatic-campaigns/{campaign_id}/pages/actions",
-    "/programmatic-campaigns/{campaign_id}/pages/{page_id}/actions",
-    "/provider-domains/{domain_id}/forwarding",
-    "/provider-domains/{domain_id}/mailbox-profile-picture",
-    "/provider-domains/{domain_id}/regenerate-nameservers",
-    "/provider-domains/{domain_id}/resend-transfer-password",
-    "/provider-domains/{domain_id}/resend-verification",
-    "/provider-domains/{domain_id}/set-nameservers",
-    "/provider-usage/refresh",
-    "/provider-usage/sync",
-    "/quote-billing-contact",
-    "/quote-contacts",
-    "/quote-settings/documents",
-    "/quote-templates",
-    "/quotes",
-    "/quotes/batch",
-    "/quotes/{quote_id}/duplicate",
-    "/quotes/{quote_id}/edit-as-draft",
-    "/quotes/{quote_id}/mark-accepted",
-    "/quotes/{quote_id}/send",
-    "/quotes/{quote_id}/unarchive",
-    "/radar/alerts/dispatch",
-    "/repos/{repo_id}/campaigns/{campaign_id}/launch",
-    "/roles/invite",
-    "/sales-coach/interviews/{interview_id}/members",
-    "/sales-coach/interviews/{interview_id}/members/{member_id}/send-invite",
-    "/sequencer/content/voice/test-call",
-    "/sequences",
-    "/sequences/generate-spintax",
-    "/sequences/{sequence_id}/contacts",
-    "/sequences/{sequence_id}/contacts/{contact_id}/resume",
-    "/sequences/{sequence_id}/pause",
-    "/sequences/{sequence_id}/resume",
-    "/sequences/{sequence_id}/run",
-    "/sequences/{sequence_id}/sync",
-    "/settings/scrape-config/crawl",
-    "/skills/{action_id}/execute",
-    "/skills/{action_id}/test-runs",
-    "/social-listeners/posts/{post_id}/add-to-sequence",
-    "/social/posts/{post_id}/engagers/add-to-audience",
-    "/social/posts/{post_id}/engagers/enroll",
-    "/social/posts/{post_id}/publish",
-    "/social/posts/{post_id}/schedule",
-    "/stripe/api-key",
-    "/stripe/sync",
-    "/team-members/sync",
-    "/voice/calls",
-    "/voice/dialer/sessions",
-    "/voice/dialer/sessions/{session_id}/resume",
-    "/voice/dispositions",
-    "/voice/inbound-calls/decline",
-    "/voice/inbound-calls/dialer/{call_id}/decline",
-    "/voice/inbound-calls/{room_name}/claim",
-    "/voice/mcp-servers/{mcp_server_id}/test",
-    "/webhooks",
-    "/webhooks/{webhook_id}/rotate-secret",
-    "/website-editor/publish",
-    "/website-editor/sync",
-    "/workbench/scraper/providers/{provider}/connection/test",
-    "/workbench/tables/{table_id}/import/crm",
-    "/workbench/tables/{table_id}/send-to-sequence",
-    "/workflows",
-    "/workflows/executions/approve",
-    "/workflows/executions/bulk-restart",
-    "/workflows/executions/request-changes",
-    "/workflows/executions/{execution_id}/pause",
-    "/workflows/executions/{execution_id}/restart",
-    "/workflows/executions/{execution_id}/resume",
-    "/workflows/executions/{execution_id}/stop",
-    "/workflows/integrations/{provider_name}/test",
-    "/workflows/validate",
-    "/workflows/workbenches",
-    "/workflows/{action_id}/execute",
-    "/workflows/{action_id}/trigger-reset"
-  ],
-  PUT: [
-    "/ad-campaigns/{campaign_id}",
-    "/appointments/calendars/destination",
-    "/appointments/conferencing/{provider}/link",
-    "/campaigns/{campaign_id}/audience",
-    "/campaigns/{campaign_id}/documents/{document_id}",
-    "/campaigns/{campaign_id}/sequence",
-    "/campaigns/{campaign_id}/sequence/steps/{step_id}",
-    "/desk/autonomy",
-    "/desk/org-settings",
-    "/inbox/linkedin/accounts/{account_id}",
-    "/integrations/crm-sync/pull-enabled",
-    "/integrations/crm-sync/push-enabled",
-    "/integrations/crm/connections/{connection_id}/batch/contacts",
-    "/integrations/crm/connections/{connection_id}/companies/{company_id}",
-    "/integrations/crm/connections/{connection_id}/contacts/{contact_id}",
-    "/integrations/crm/connections/{connection_id}/deals/{deal_id}",
-    "/integrations/crm/connections/{connection_id}/leads/{lead_id}",
-    "/integrations/linkedin-outreach/workspaces/active",
-    "/linkedin/accounts/{account_id}/schedule",
-    "/newsletters/{newsletter_id}/issues/{issue_id}",
-    "/quote-settings",
-    "/quote-templates/{template_id}",
-    "/quotes/{quote_id}",
-    "/sms/phone-numbers/{phone_number}",
-    "/social/autopilot/{account_id}",
-    "/workflows/{action_id}"
-  ]
-};
-
-// src/http.ts
-var G8Error = class _G8Error extends Error {
-  constructor(args) {
-    super(args.message);
-    this.name = "G8Error";
-    this.status = args.status;
-    this.type = args.type;
-    this.code = args.code;
-    this.requestId = args.requestId;
-    this.detail = args.detail;
-    this.retryable = args.retryable ?? false;
-    Object.setPrototypeOf(this, _G8Error.prototype);
-  }
-};
-function isRetryableStatus(status) {
-  return status === 429 || status >= 500 && status <= 599;
-}
-function isWriteMethod(method) {
-  const m = method.toUpperCase();
-  return m === "POST" || m === "PUT" || m === "PATCH" || m === "DELETE";
-}
-var API_BASE_SEGMENT = "/api/v1";
-var billableMatchers = null;
-var externalMatchers = null;
-function templateToRegexSource(template) {
-  return template.split(/(\{[^}/]+\})/).map((part) => /^\{[^}/]+\}$/.test(part) ? "[^/]+" : part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("");
-}
-function buildMatchers(routes) {
-  const out = /* @__PURE__ */ new Map();
-  for (const [m, templates] of Object.entries(routes)) {
-    if (!templates.length) continue;
-    out.set(m, new RegExp(`^(?:${templates.map(templateToRegexSource).join("|")})/?$`));
-  }
-  return out;
-}
-function matcherFor(method) {
-  if (!billableMatchers) billableMatchers = buildMatchers(BILLABLE_ROUTES);
-  return billableMatchers.get(method.toUpperCase());
-}
-function externalMatcherFor(method) {
-  if (!externalMatchers) externalMatchers = buildMatchers(EXTERNAL_ROUTES);
-  return externalMatchers.get(method.toUpperCase());
-}
-function apiRelativePath(urlOrPath) {
-  let p = urlOrPath.replace(/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\/[^/]*/, "");
-  p = p.split(/[?#]/, 1)[0];
-  const at = p.indexOf(API_BASE_SEGMENT + "/");
-  if (at < 0) return null;
-  return p.slice(at + API_BASE_SEGMENT.length);
-}
-function isBillableOperation(method, urlOrPath) {
-  const matcher = matcherFor(method);
-  if (!matcher) return false;
-  const p = apiRelativePath(urlOrPath);
-  return p != null && matcher.test(p);
-}
-function isExternalOperation(method, urlOrPath) {
-  const matcher = externalMatcherFor(method);
-  if (!matcher) return false;
-  const p = apiRelativePath(urlOrPath);
-  return p != null && matcher.test(p);
-}
-function isNoBlindRetryOperation(method, urlOrPath) {
-  return isBillableOperation(method, urlOrPath) || isExternalOperation(method, urlOrPath);
-}
-var PRE_SEND_ERROR_CODES = /* @__PURE__ */ new Set([
-  "ECONNREFUSED",
-  "ENOTFOUND",
-  "EAI_AGAIN",
-  "ENETUNREACH",
-  "EHOSTUNREACH",
-  "UND_ERR_CONNECT_TIMEOUT"
-]);
-function isPreSendNetworkError(err) {
-  let cur = err;
-  for (let depth = 0; cur && depth < 4; depth++) {
-    if (typeof cur.code === "string" && PRE_SEND_ERROR_CODES.has(cur.code)) return true;
-    if (Array.isArray(cur.errors) && cur.errors.some((e) => isPreSendNetworkError(e))) return true;
-    cur = cur.cause;
-  }
-  return false;
-}
-function newIdempotencyKey() {
-  const c = globalThis.crypto;
-  if (c?.randomUUID) return c.randomUUID();
-  if (c?.getRandomValues) {
-    const bytes = c.getRandomValues(new Uint8Array(16));
-    return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
-  }
-  return `g8-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`;
-}
-function parseRetryAfter(header, nowMs = Date.now()) {
-  if (!header) return null;
-  const secs = Number(header);
-  if (Number.isFinite(secs) && secs >= 0) return Math.round(secs * 1e3);
-  const dateMs = Date.parse(header);
-  if (!Number.isNaN(dateMs)) {
-    const delta = dateMs - nowMs;
-    return delta > 0 ? delta : 0;
-  }
-  return null;
-}
-function backoffDelayMs(attempt, baseMs = 200, rand = Math.random) {
-  const expo = Math.min(baseMs * 2 ** attempt, 1e4);
-  return Math.floor(expo / 2 + rand() * (expo / 2));
-}
-function defaultSleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function buildQuery(query) {
-  if (!query) return "";
-  const qs = new URLSearchParams();
-  for (const [k, v] of Object.entries(query)) {
-    if (v != null) qs.set(k, String(v));
-  }
-  const s = qs.toString();
-  return s ? `?${s}` : "";
-}
-async function toG8Error(resp, retryable = isRetryableStatus(resp.status)) {
-  let body = void 0;
-  try {
-    const text = await resp.text();
-    body = text ? JSON.parse(text) : void 0;
-  } catch {
-    body = void 0;
-  }
-  const env = body ?? {};
-  const message = typeof env.message === "string" && env.message || typeof env.error === "string" && env.error || `Request failed with status ${resp.status}`;
-  return new G8Error({
-    message,
-    status: resp.status,
-    type: typeof env.type === "string" && env.type || typeof env.error === "string" && env.error || "api_error",
-    code: typeof env.code === "string" ? env.code : String(resp.status),
-    requestId: typeof env.request_id === "string" && env.request_id || resp.headers.get("x-request-id") || void 0,
-    detail: env.detail,
-    retryable
-  });
-}
-var TARGET_ORG_HEADER = "x-target-org-id";
-var nonAgencyKeys = /* @__PURE__ */ new Set();
-var warnedTargetOrgKeys = /* @__PURE__ */ new Set();
-function keyFingerprint(apiKey) {
-  let h = 2166136261;
-  for (let i = 0; i < apiKey.length; i++) {
-    h ^= apiKey.charCodeAt(i);
-    h = Math.imul(h, 16777619) >>> 0;
-  }
-  return `${apiKey.length}:${h.toString(36)}`;
-}
-function warnIfTargetOrgIgnored(apiKey, headers) {
-  if (!Object.keys(headers).some((h) => h.toLowerCase() === TARGET_ORG_HEADER)) return;
-  const fp = keyFingerprint(apiKey);
-  if (!nonAgencyKeys.has(fp) || warnedTargetOrgKeys.has(fp)) return;
-  warnedTargetOrgKeys.add(fp);
-  if (typeof console !== "undefined" && typeof console.warn === "function") {
-    console.warn(
-      "[@graph8/sdk] X-Target-Org-Id is set, but the server reported this API key is not an agency key. The header is ignored for non-agency keys: this call runs against the key's own org. Use an agency key (minted with is_agency=true) to target a client org."
-    );
-  }
-}
-async function request(baseUrl, path6, apiKey, opts = {}) {
-  const {
-    method = "GET",
-    body,
-    headers = {},
-    query,
-    idempotencyKey,
-    maxRetries = 2,
-    retryBaseMs = 200,
-    signal,
-    fetchImpl = fetch,
-    sleepImpl = defaultSleep
-  } = opts;
-  const url = baseUrl.replace(/\/+$/, "") + path6 + buildQuery(query);
-  const finalHeaders = {
-    "Content-Type": "application/json",
-    Authorization: `Bearer ${apiKey}`,
-    ...clientIdentityHeaders(headers),
-    ...headers
-  };
-  warnIfTargetOrgIgnored(apiKey, headers);
-  const effectiveIdempotencyKey = idempotencyKey ?? (maxRetries > 0 && isWriteMethod(method) ? newIdempotencyKey() : void 0);
-  if (effectiveIdempotencyKey) finalHeaders["Idempotency-Key"] = effectiveIdempotencyKey;
-  const billable = isNoBlindRetryOperation(method, url);
-  let attempt = 0;
-  for (; ; ) {
-    let resp;
-    try {
-      resp = await fetchImpl(url, {
-        method,
-        headers: finalHeaders,
-        body: body == null ? void 0 : JSON.stringify(body),
-        signal
-      });
-    } catch (err) {
-      const safeToRetry = !billable || isPreSendNetworkError(err);
-      if (attempt < maxRetries && safeToRetry) {
-        await sleepImpl(backoffDelayMs(attempt, retryBaseMs));
-        attempt++;
-        continue;
-      }
-      throw new G8Error({
-        message: `Network error: ${err?.message ?? "request failed"}`,
-        status: 0,
-        type: "network_error",
-        retryable: safeToRetry
-      });
-    }
-    if (resp.ok) {
-      const text = await resp.text();
-      return text ? JSON.parse(text) : void 0;
-    }
-    const statusRetryable = isRetryableStatus(resp.status) && (!billable || resp.status === 429);
-    if (statusRetryable && attempt < maxRetries) {
-      const retryAfter = parseRetryAfter(resp.headers.get("retry-after"));
-      const delay = retryAfter != null ? retryAfter : backoffDelayMs(attempt, retryBaseMs);
-      await sleepImpl(delay);
-      attempt++;
-      continue;
-    }
-    throw await toG8Error(resp, billable ? statusRetryable : isRetryableStatus(resp.status));
-  }
-}
-function isServerRuntime() {
-  const g = globalThis;
-  if (typeof g.window !== "undefined") return false;
-  return typeof g.process?.versions?.node === "string";
-}
-function runtimeUserAgent() {
-  const g = globalThis;
-  const node = typeof g.process?.version === "string" ? ` node/${g.process.version.replace(/^v/, "")}` : "";
-  return `graph8-sdk-js/${SDK_VERSION}${node}`;
-}
-function clientIdentityHeaders(callerHeaders = {}) {
-  const taken = new Set(Object.keys(callerHeaders).map((h) => h.toLowerCase()));
-  const out = {};
-  if (!taken.has("x-g8-client")) out["X-G8-Client"] = SDK_CLIENT_ID;
-  if (!taken.has("user-agent") && isServerRuntime()) out["User-Agent"] = runtimeUserAgent();
-  return out;
-}
-async function* paginate(fetchPage) {
-  let cursor = void 0;
-  for (; ; ) {
-    const page = await fetchPage(cursor);
-    for (const item of page.data ?? []) yield item;
-    const next = page.pagination?.next_cursor;
-    if (!next) break;
-    cursor = next;
-  }
-}
 
 // src/generated/operations.ts
 var API_OPERATIONS = {
@@ -2113,6 +512,7 @@ var API_OPERATIONS = {
   create_deal_deals_post: ["POST", "/deals", "deals", "createDeal", "write", "deals:write"],
   create_deal_note_deals__deal_id__notes_post: ["POST", "/deals/{deal_id}/notes", "notes", "createDealNote", "write", "notes:write"],
   create_default_waterfall_config_enrichment_waterfall_configs_post: ["POST", "/enrichment/waterfall/configs", "enrichment", "createDefaultWaterfallConfig", "billable", "enrichment:run"],
+  create_desk_card_desk_cards_post: ["POST", "/desk/cards", "desk", "createDeskCard", "write", "deals:write"],
   create_dialer_session_voice_dialer_sessions_post: ["POST", "/voice/dialer/sessions", "voice", "createDialerSession", "external", "voice:run"],
   create_dynamic_column_enrichment_columns_post: ["POST", "/enrichment/columns", "enrichment", "createDynamicColumn", "write", "enrichment:write"],
   create_empty_list_lists_create_empty_post: ["POST", "/lists/create-empty", "lists", "createEmptyList", "write", "lists:write"],
@@ -5089,7 +3489,2542 @@ var API_OPERATIONS = {
   withdraw_contacts_from_sequences_contacts_withdraw_from_sequences_post: ["POST", "/contacts/withdraw-from-sequences", "contacts", "withdrawContactsFromSequences", "write", "contacts:write"],
   withdraw_org_hiring_marketplace_org_hirings__hiring_id__withdraw_post: ["POST", "/marketplace/org/hirings/{hiring_id}/withdraw", "marketplace", "withdrawOrgHiring", "billable", "marketplace:run"]
 };
-var API_OPERATION_IDS = Object.keys(API_OPERATIONS);
+var API_OPERATION_IDS = Object.keys(API_OPERATIONS);
+
+// src/blocks/prefixes.ts
+var PREFIX_START = "// graph8:allowed-prefixes:start";
+var PREFIX_END = "// graph8:allowed-prefixes:end";
+var LEGACY_LINE = /^const allowedPrefixes: string\[\] \| undefined = undefined;[^\n]*$/m;
+var OPS = API_OPERATIONS;
+function prefixOf(operationId) {
+  const p = OPS[operationId]?.[1];
+  if (typeof p !== "string") return null;
+  const first = p.replace(/^\/+/, "").split("/")[0];
+  return first && !first.startsWith("{") ? first : null;
+}
+function derivePrefixes(blocks) {
+  const out = /* @__PURE__ */ new Set();
+  for (const b of blocks) for (const id of b.operations) {
+    const p = prefixOf(id);
+    if (p) out.add(p);
+  }
+  return [...out].sort();
+}
+function formatPrefixes(prefixes) {
+  if (!prefixes.length) return "[]";
+  const items = prefixes.map((p) => JSON.stringify(p));
+  const one = `[${items.join(", ")}]`;
+  if (one.length <= 80) return one;
+  const lines = [];
+  let cur = "";
+  for (const it of items) {
+    const next = cur ? `${cur} ${it},` : `${it},`;
+    if (cur && next.length + 2 > 110) {
+      lines.push(cur);
+      cur = `${it},`;
+    } else cur = next;
+  }
+  if (cur) lines.push(cur);
+  return `[
+${lines.map((l) => `  ${l}`).join("\n")}
+]`;
+}
+function prefixRegion(prefixes) {
+  return [
+    PREFIX_START,
+    `// Generated from the operations of the installed blocks. Regenerate: npx @graph8/sdk doctor --fix-prefixes`,
+    `const allowedPrefixes: string[] | undefined = ${formatPrefixes(prefixes)};`,
+    PREFIX_END
+  ].join("\n");
+}
+function hasPrefixRegion(source) {
+  const a = source.indexOf(PREFIX_START);
+  return a >= 0 && source.indexOf(PREFIX_END, a) > a;
+}
+function applyPrefixes(source, prefixes) {
+  const a = source.indexOf(PREFIX_START);
+  const b = a >= 0 ? source.indexOf(PREFIX_END, a) : -1;
+  if (a < 0 || b < 0) return null;
+  return `${source.slice(0, a)}${prefixRegion(prefixes)}${source.slice(b + PREFIX_END.length)}`;
+}
+function upgradeLegacyRoute(source, prefixes) {
+  return LEGACY_LINE.test(source) ? source.replace(LEGACY_LINE, prefixRegion(prefixes)) : null;
+}
+function stripComments(source) {
+  return source.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:"'`])\/\/[^\n]*/g, "$1");
+}
+function inspectRoute(source) {
+  const code = stripComments(source);
+  const flag = (name) => new RegExp(`\\b${name}\\s*:\\s*true\\b`).test(code);
+  const m = /\bconst\s+allowedPrefixes\b[^=]*=\s*([^;]*);/.exec(code);
+  let prefixes = "custom";
+  const expr = m?.[1].trim();
+  if (!m || expr === "undefined") prefixes = void 0;
+  else if (expr && /^\[[\s\S]*\]$/.test(expr) && /^\[(\s*(["'])[^"'\n]*\2\s*,?)*\s*\]$/.test(expr)) {
+    prefixes = [...expr.matchAll(/(["'])([^"'\n]*)\1/g)].map((x) => x[2]);
+  }
+  if (!m && /\ballowedPrefixes\s*:/.test(code)) prefixes = "custom";
+  return {
+    // A property of the config object: `authorize: fn`, `authorize,` (shorthand) or `authorize(req) {` (method).
+    authorize: /[{,]\s*authorize\s*[:,}(]/.test(code),
+    localPreview: flag("localPreview"),
+    dangerouslyAllowUnauthenticated: flag("dangerouslyAllowUnauthenticated"),
+    dangerouslyAllowAllPaths: flag("dangerouslyAllowAllPaths"),
+    prefixes,
+    generated: hasPrefixRegion(source)
+  };
+}
+
+// src/blocks/screens.ts
+var import_node_fs3 = __toESM(require("fs"));
+var import_node_path4 = __toESM(require("path"));
+
+// src/blocks/compose.ts
+var import_node_fs2 = __toESM(require("fs"));
+var import_node_path3 = __toESM(require("path"));
+
+// src/blocks/registry.ts
+var import_node_fs = __toESM(require("fs"));
+var import_node_path2 = __toESM(require("path"));
+function arr(v) {
+  return Array.isArray(v) ? v : [];
+}
+function readJson(file) {
+  try {
+    const parsed = JSON.parse(import_node_fs.default.readFileSync(file, "utf8"));
+    return parsed && typeof parsed === "object" ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function toBlock(raw, dir, root) {
+  if (typeof raw.id !== "string" || !raw.id) return null;
+  return {
+    id: raw.id,
+    title: typeof raw.title === "string" ? raw.title : raw.id,
+    summary: typeof raw.summary === "string" ? raw.summary : "",
+    features: arr(raw.features),
+    dependsOn: arr(raw.dependsOn),
+    operations: arr(raw.operations),
+    components: arr(raw.components),
+    ...Array.isArray(raw.screens) ? { screens: arr(raw.screens) } : {},
+    hooks: arr(raw.hooks),
+    lib: arr(raw.lib),
+    server: arr(raw.server),
+    recipes: arr(raw.recipes),
+    prerequisites: arr(raw.prerequisites),
+    scopes: arr(raw.scopes),
+    defaults: arr(raw.defaults),
+    peerDependencies: raw.peerDependencies ?? {},
+    dir,
+    root
+  };
+}
+function loadRegistry(blocksRoot) {
+  const blocks = [];
+  if (import_node_fs.default.existsSync(blocksRoot)) {
+    for (const entry of import_node_fs.default.readdirSync(blocksRoot, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+      if (!entry.isDirectory()) continue;
+      const root = import_node_path2.default.join(blocksRoot, entry.name);
+      const raw = readJson(import_node_path2.default.join(root, "block.json"));
+      const block = raw && toBlock(raw, entry.name, root);
+      if (block) blocks.push(block);
+    }
+  }
+  const stacks = [];
+  const stacksDir = import_node_path2.default.join(import_node_path2.default.dirname(blocksRoot), "stacks");
+  if (import_node_fs.default.existsSync(stacksDir)) {
+    for (const file of import_node_fs.default.readdirSync(stacksDir).filter((f) => f.endsWith(".json")).sort()) {
+      const raw = readJson(import_node_path2.default.join(stacksDir, file));
+      if (!raw || typeof raw.id !== "string") continue;
+      stacks.push({
+        id: raw.id,
+        title: typeof raw.title === "string" ? raw.title : raw.id,
+        summary: typeof raw.summary === "string" ? raw.summary : "",
+        status: raw.status === "planned" ? "planned" : "available",
+        blocks: arr(raw.blocks),
+        nav: arr(raw.nav),
+        ...typeof raw.home === "string" ? { home: raw.home } : {}
+      });
+    }
+  }
+  return { blocks, stacks, stacksRoot: stacksDir };
+}
+function findBlock(reg, id) {
+  return reg.blocks.find((b) => b.id === id);
+}
+function resolveWithDeps(reg, ids) {
+  const ordered = [];
+  const done = /* @__PURE__ */ new Set();
+  const visiting = [];
+  const visit = (id) => {
+    if (done.has(id)) return;
+    if (visiting.includes(id)) throw new Error(`dependency cycle: ${[...visiting, id].join(" -> ")}`);
+    const block = findBlock(reg, id);
+    if (!block) {
+      const from = visiting.length ? ` (required by ${visiting[visiting.length - 1]})` : "";
+      throw new Error(`unknown block "${id}"${from}. Run \`graph8-sdk list\` to see the available blocks.`);
+    }
+    visiting.push(id);
+    for (const dep of block.dependsOn) visit(dep);
+    visiting.pop();
+    done.add(id);
+    ordered.push(block);
+  };
+  ids.forEach(visit);
+  return ordered;
+}
+function searchBlocks(reg, text) {
+  const needle = text.trim().toLowerCase();
+  if (!needle) return [];
+  return reg.blocks.filter(
+    (b) => [b.id, b.title, b.summary, ...b.features, ...b.components.map((c) => c.name)].some((s) => s.toLowerCase().includes(needle))
+  );
+}
+function searchStacks(reg, text) {
+  const needle = text.trim().toLowerCase();
+  if (!needle) return [];
+  return reg.stacks.filter((s) => [s.id, s.title, s.summary].some((x) => x.toLowerCase().includes(needle)));
+}
+function screenNames(b) {
+  return b.components.map((c) => c.name).filter((n) => n.endsWith("Screen"));
+}
+function blockSummary(b) {
+  const screens = [.../* @__PURE__ */ new Set([...screenNames(b), ...(b.screens ?? []).map((x) => x.component)])];
+  return {
+    id: b.id,
+    title: b.title,
+    summary: b.summary,
+    dependsOn: b.dependsOn,
+    components: b.components.map((c) => c.name),
+    ...screens.length ? { screens } : {}
+  };
+}
+function stackStatus(reg, s) {
+  const missing = s.blocks.filter((id) => !findBlock(reg, id));
+  return { status: missing.length ? "planned" : "available", missing };
+}
+function stackSummary(s, reg) {
+  const base = { id: s.id, title: s.title, summary: s.summary, blocks: s.blocks };
+  if (!reg) return base;
+  const { status, missing } = stackStatus(reg, s);
+  return { ...base, status, ...missing.length ? { missingBlocks: missing } : {} };
+}
+function catalogSection(reg) {
+  if (!reg.blocks.length && !reg.stacks.length) return void 0;
+  const lines = [
+    "### Build an app from graph8 blocks",
+    "",
+    "To build an app: `npx @graph8/sdk create --blocks <ids> <dir>` (for example `--blocks crm,deals,inbox`). Dependencies come with it, and every block's",
+    "finished screens become routes plus a sidebar entry. Use a stack below instead when one matches the product you are building.",
+    "",
+    "### graph8 blocks",
+    "",
+    "Ready-made, copy-in UI + hooks per graph8 feature. Pick from this list instead of reading every README:",
+    ""
+  ];
+  for (const b of reg.blocks) {
+    const deps = b.dependsOn.length ? ` (needs ${b.dependsOn.join(", ")})` : "";
+    const screens = [.../* @__PURE__ */ new Set([...screenNames(b), ...(b.screens ?? []).map((x) => x.component)])];
+    lines.push(`- block \`${b.id}\`: ${b.summary}${deps}${screens.length ? ` Screens (start here): ${screens.join(", ")}.` : ""}`);
+  }
+  for (const s of reg.stacks) {
+    const { missing } = stackStatus(reg, s);
+    const planned = missing.length ? ` [planned, not creatable yet: missing blocks ${missing.join(", ")}]` : "";
+    lines.push(`- stack \`${s.id}\`: ${s.summary} (blocks: ${s.blocks.join(", ")})${planned}`);
+  }
+  lines.push(
+    "",
+    "Add one: `npx @graph8/sdk add <block>[/<Component>]` (dependencies and the `foundation` block come with it). Find one:",
+    "`npx @graph8/sdk list` / `search <text>`. Check setup: `npx @graph8/sdk doctor --blocks a,b`."
+  );
+  if (reg.stacks.some((s) => !stackStatus(reg, s).missing.length)) lines.push("Start a whole app from an available stack: `npx @graph8/sdk create <stack> <dir>` (Next.js + the stack's blocks wired into a sidebar).");
+  return lines.join("\n");
+}
+
+// src/blocks/compose.ts
+var BLOCK_ICONS = {
+  agents: "Bot",
+  analytics: "ChartBar",
+  appointments: "CalendarDays",
+  campaigns: "Rocket",
+  coach: "GraduationCap",
+  copilot: "MessageCircle",
+  crm: "Users",
+  deals: "Handshake",
+  dialer: "Phone",
+  enrichment: "Sparkles",
+  forms: "ClipboardList",
+  inbox: "Inbox",
+  integrations: "Plug",
+  intent: "Target",
+  lifecycle: "Repeat",
+  lists: "ListChecks",
+  mailboxes: "Mail",
+  newsletter: "Newspaper",
+  nurture: "Sprout",
+  objects: "Boxes",
+  pages: "LayoutTemplate",
+  quotes: "FileText",
+  radar: "Radar",
+  search: "Search",
+  sequencer: "Send",
+  "social-ads": "Megaphone",
+  visitors: "Eye",
+  webchat: "MessageSquare",
+  workbench: "Table2",
+  workflows: "Workflow"
+};
+var FALLBACK_ICON = "LayoutGrid";
+var words = (pascal) => pascal.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").split(" ").filter(Boolean);
+var kebab = (pascal) => words(pascal).map((w) => w.toLowerCase()).join("-");
+var sentence = (pascal) => {
+  const w = words(pascal).map((x) => x.toLowerCase());
+  return w.length ? w[0][0].toUpperCase() + w[0].slice(1) + (w.length > 1 ? ` ${w.slice(1).join(" ")}` : "") : pascal;
+};
+function matching(s, open, pair) {
+  let depth = 0;
+  for (let i = open; i < s.length; i++) {
+    if (s[i] === pair[0]) depth++;
+    else if (s[i] === pair[1] && --depth === 0) return i;
+  }
+  return -1;
+}
+function requiredMembers(body) {
+  const out = [];
+  let depth = 0;
+  let cur = "";
+  const flush = () => {
+    const m = /^\s*(?:readonly\s+)?([A-Za-z_$][\w$]*)\s*(\?)?\s*:/.exec(cur.replace(/\/\*[\s\S]*?\*\/|\/\/[^\n]*/g, ""));
+    if (m && !m[2]) out.push(m[1]);
+    cur = "";
+  };
+  for (const ch of body) {
+    if ("{[(<".includes(ch)) depth++;
+    else if ("}])>".includes(ch) && !(ch === ">" && cur.endsWith("="))) depth--;
+    if (depth === 0 && (ch === ";" || ch === "," || ch === "\n")) flush();
+    else cur += ch;
+  }
+  flush();
+  return out;
+}
+function typeBody(source, typeName) {
+  const m = new RegExp(`(?:interface\\s+${typeName}\\b[^{=]*|type\\s+${typeName}\\s*=\\s*)\\{`).exec(source);
+  if (!m) return null;
+  const open = m.index + m[0].length - 1;
+  const close = matching(source, open, ["{", "}"]);
+  return close < 0 ? null : source.slice(open + 1, close);
+}
+function takesNoRequiredProps(source, name) {
+  const m = new RegExp(`export\\s+(?:default\\s+)?(?:async\\s+)?function\\s+${name}\\s*(?:<[^>]*>)?\\(|export\\s+const\\s+${name}\\s*(?::[^=]+)?=\\s*(?:async\\s*)?(?:<[^>]*>)?\\(`).exec(source);
+  if (!m) return false;
+  const open = m.index + m[0].length - 1;
+  const close = matching(source, open, ["(", ")"]);
+  if (close < 0) return false;
+  const params = source.slice(open + 1, close).trim();
+  if (!params) return true;
+  if (/=\s*\{\s*\}\s*$/.test(params)) return true;
+  const colon = params.indexOf(":");
+  const type = (colon < 0 ? "" : params.slice(colon + 1)).trim();
+  if (!type) return false;
+  if (type.startsWith("{")) {
+    const close2 = matching(type, 0, ["{", "}"]);
+    return close2 > 0 && requiredMembers(type.slice(1, close2)).length === 0;
+  }
+  const named = /^([A-Za-z_$][\w$]*)$/.exec(type);
+  const body = named ? typeBody(source, named[1]) : null;
+  return body !== null && requiredMembers(body).length === 0;
+}
+function readSource(block, file) {
+  try {
+    return import_node_fs2.default.readFileSync(import_node_path3.default.join(block.root, file), "utf8");
+  } catch {
+    return "";
+  }
+}
+function screensOf(block) {
+  const base = BLOCK_ICONS[block.id] ?? FALLBACK_ICON;
+  const have = new Set(block.components.map((c) => c.name));
+  const make = (component, p, label, extra = {}, fallback2 = false) => ({
+    block: block.id,
+    component,
+    path: p,
+    label,
+    icon: extra.icon ?? base,
+    group: extra.group ?? block.title,
+    ...extra.description ? { description: extra.description } : {},
+    fallback: fallback2
+  });
+  if (block.screens?.length) {
+    const declared = block.screens.filter((s) => have.has(s.component));
+    return declared.map((s, i) => ({ s, i })).sort((a, b) => (a.s.order ?? 1e6) - (b.s.order ?? 1e6) || a.i - b.i).map(({ s }) => make(s.component, s.path, s.label, s));
+  }
+  const derived = block.components.map((c) => c.name).filter((n) => n.endsWith("Screen") && n.length > "Screen".length);
+  if (derived.length) return derived.map((n) => make(n, `/${kebab(n.slice(0, -"Screen".length))}`, sentence(n.slice(0, -"Screen".length))));
+  const fallback = block.components.find((c) => takesNoRequiredProps(readSource(block, c.file), c.name));
+  return fallback ? [make(fallback.name, `/${block.id}`, block.title, {}, true)] : [];
+}
+var hasRealScreen = (block) => screensOf(block).some((s) => !s.fallback);
+function uniquePaths(screens) {
+  const taken = /* @__PURE__ */ new Set();
+  return screens.map((s) => {
+    let p = s.path;
+    const prefixed = `/${s.block}${s.path === "/" ? "" : s.path}`;
+    if (taken.has(p)) p = prefixed;
+    for (let n = 2; taken.has(p); n++) p = `${prefixed}-${n}`;
+    taken.add(p);
+    return { ...s, path: p };
+  });
+}
+function composeApp(reg, ids, opts = {}) {
+  const requested = [...new Set(ids)];
+  const closure = resolveWithDeps(reg, requested);
+  const depOnly = closure.filter((b) => !requested.includes(b.id) && b.id !== "foundation");
+  const warnings = [];
+  const chosen = [];
+  for (const id of requested) {
+    const block = findBlock(reg, id);
+    if (id === "foundation") continue;
+    const screens2 = screensOf(block);
+    if (!screens2.length) warnings.push(`block "${id}" has no screen and no component that renders without props: it adds no page (wire its components yourself).`);
+    else if (screens2[0].fallback) warnings.push(`block "${id}" has no finished Screen yet: its page is the plain ${screens2[0].component} component.`);
+    chosen.push(...screens2);
+  }
+  if (!opts.noDepsScreens) {
+    for (const block of depOnly) chosen.push(...screensOf(block).filter((s) => opts.withDepsScreens || !s.fallback));
+  }
+  const screens = uniquePaths(chosen);
+  const nav = screens.map((s) => ({
+    label: s.label,
+    path: s.path,
+    block: s.block,
+    component: s.component,
+    icon: s.icon,
+    group: s.group,
+    ...s.description ? { description: s.description } : {}
+  }));
+  const home = screens.find((s) => s.block === "analytics" && !s.fallback)?.path ?? screens[0]?.path;
+  const stack = {
+    id: "custom",
+    title: opts.title?.trim() || "graph8 app",
+    summary: `Custom app: ${requested.join(", ")}`,
+    status: "available",
+    blocks: closure.map((b) => b.id),
+    nav,
+    ...home ? { home } : {}
+  };
+  return { stack, screens, warnings };
+}
+
+// src/blocks/navfile.ts
+function render(template, vars2) {
+  return template.replace(/\{\{(\w+)\}\}/g, (_m, key) => {
+    if (!(key in vars2)) throw new Error(`template placeholder {{${key}}} has no value`);
+    return vars2[key];
+  });
+}
+function pageFileFor(navPath) {
+  const segs = navPath.split("/").filter(Boolean);
+  return ["app", ...segs, "page.tsx"].join("/");
+}
+function componentImportPath(block, file) {
+  const rel = installedRel(file) ?? file;
+  return `@/components/g8/${block.dir}/${rel.replace(/\.(tsx|ts|jsx|js)$/, "")}`;
+}
+function navUsesExtras(nav) {
+  return nav.some((n) => n.icon || n.group || n.description);
+}
+function navPartsFor(nav) {
+  if (!navUsesExtras(nav)) {
+    return { navImports: "", navType: "{ label: string; path: string }[]", navJson: JSON.stringify(nav.map((n) => ({ label: n.label, path: n.path })), null, 2) };
+  }
+  const icons = [...new Set(nav.flatMap((n) => n.icon ? [n.icon] : []))].sort();
+  const named = [...icons, "type LucideIcon"].join(", ");
+  const items = nav.map((n) => ({
+    label: n.label,
+    path: n.path,
+    ...n.icon ? { icon: `__ICON__${n.icon}` } : {},
+    ...n.group ? { group: n.group } : {},
+    ...n.description ? { description: n.description } : {}
+  }));
+  return {
+    navImports: [
+      `import { ${named} } from "lucide-react";`,
+      "",
+      "export type NavItem = { label: string; path: string; icon?: LucideIcon; group?: string; description?: string };",
+      "",
+      ""
+    ].join("\n"),
+    navType: "NavItem[]",
+    navJson: JSON.stringify(items, null, 2).replace(/"__ICON__(\w+)"/g, "$1")
+  };
+}
+function navParts(stack) {
+  return navPartsFor(stack.nav);
+}
+
+// src/blocks/screens.ts
+var NAV_FILES = ["lib/nav.ts", "src/lib/nav.ts"];
+function parseNavFile(text) {
+  const decl = /export const nav\s*:[^=]*=\s*(\[[\s\S]*\]);?\s*$/.exec(text);
+  if (!decl) return null;
+  const first = /^(?:import |export )/m.exec(text);
+  try {
+    const quoted2 = decl[1].replace(/("icon":\s*)([A-Za-z_][A-Za-z0-9_]*)/g, '$1"$2"');
+    const items = JSON.parse(quoted2);
+    if (!Array.isArray(items) || items.some((i) => typeof i?.path !== "string" || typeof i?.label !== "string")) return null;
+    return { header: first ? text.slice(0, first.index) : "", items };
+  } catch {
+    return null;
+  }
+}
+function toNavEntry(s) {
+  return { label: s.label, path: s.path, icon: s.icon, group: s.group, ...s.description ? { description: s.description } : {} };
+}
+function candidates(blocks) {
+  const main = blocks[blocks.length - 1];
+  return [main, ...blocks.filter((b) => b !== main)].filter((b) => b.id !== "foundation").flatMap((b) => screensOf(b).filter((s) => b === main || !s.fallback));
+}
+function importAlias(target) {
+  const t = target.replace(/^src\//, "");
+  return `@/${t}`;
+}
+function planScreenWiring(input) {
+  const navRel = NAV_FILES.find((f) => import_node_fs3.default.existsSync(import_node_path4.default.join(input.root, f)));
+  const none = { files: [], notes: [], screens: [], usesIcons: false };
+  if (!navRel) return null;
+  const navText = import_node_fs3.default.readFileSync(import_node_path4.default.join(input.root, navRel), "utf8");
+  const parsed = parseNavFile(navText);
+  const useSrc = navRel.startsWith("src/");
+  const appRel = (rel) => useSrc ? `src/${rel}` : rel;
+  const pageTpl = import_node_fs3.default.readFileSync(import_node_path4.default.join(input.templatesRoot, "next-app", "_pages", "route-page.tsx.tmpl"), "utf8");
+  const items = parsed ? [...parsed.items] : [];
+  const taken = /* @__PURE__ */ new Set([...items.map((i) => i.path), ...input.recorded.map((r) => r.path)]);
+  const files = [];
+  const notes = [];
+  const out = { ...none, screens: [] };
+  const manual = [];
+  for (const s of candidates(input.blocks)) {
+    if (input.recorded.some((r) => r.block === s.block && r.component === s.component)) continue;
+    const block = input.blocks.find((b) => b.id === s.block);
+    const comp = block.components.find((c) => c.name === s.component);
+    if (!comp) continue;
+    const prefixed = `/${s.block}${s.path === "/" ? "" : s.path}`;
+    const importPath = componentImportPath(block, comp.file).replace("@/components/g8", importAlias(input.target));
+    const content = render(pageTpl, {
+      stackId: input.stackId,
+      block: block.id,
+      blockDir: `${input.target}/${block.dir}`,
+      component: s.component,
+      importPath,
+      propsJson: "{}"
+    });
+    const handWritten = (x) => {
+      const file = import_node_path4.default.join(input.root, appRel(pageFileFor(x)));
+      return import_node_fs3.default.existsSync(file) && import_node_fs3.default.readFileSync(file, "utf8") !== content;
+    };
+    const isTaken = (x) => taken.has(x) || handWritten(x);
+    let p = s.path;
+    if (isTaken(p)) p = prefixed;
+    for (let n = 2; isTaken(p); n++) p = `${prefixed}-${n}`;
+    if (p !== s.path && !taken.has(s.path) && handWritten(s.path)) notes.push(`kept your edited ${appRel(pageFileFor(s.path))} (not generated by graph8); wiring ${p} instead`);
+    const screen = { ...s, path: p };
+    taken.add(p);
+    const rel = appRel(pageFileFor(p));
+    const abs = import_node_path4.default.join(input.root, rel);
+    if (import_node_fs3.default.existsSync(abs)) {
+      files.push({ rel, content, action: "unchanged" });
+    } else files.push({ rel, content, action: "create" });
+    out.screens.push({ block: s.block, component: s.component, path: p });
+    (parsed ? items : manual).push(toNavEntry(screen));
+  }
+  if (!out.screens.length) return { ...out, files, notes };
+  if (parsed) {
+    const { navImports, navType, navJson } = navPartsFor(items);
+    const next = `${parsed.header}${navImports}export const nav: ${navType} = ${navJson};
+`;
+    files.push({ rel: navRel, content: next, action: next === navText ? "unchanged" : "update" });
+    out.usesIcons = items.some((i) => i.icon);
+  } else {
+    notes.push(`could not update ${navRel} (it no longer has the generated shape). Add these entries yourself:`);
+    for (const m of manual) notes.push(`  ${JSON.stringify(m)}`);
+  }
+  return { ...out, files, notes };
+}
+
+// src/blocks/add.ts
+var ADD_USAGE = `Usage: npx @graph8/sdk add <block>[/<Component>] [options]
+
+Copy a graph8 block (components, hooks, recipes) into your app. The block's
+dependencies (always including \`foundation\`) are added first.
+  --dir <path>      project root (default: current directory)
+  --target <path>   where to copy, relative to --dir (default: components/g8)
+  --dry-run         print what would change, write and install nothing
+  --force           overwrite files that differ from the template
+  --no-install      do not install missing peer dependencies
+  --routes          also add the block's screens as routes and sidebar entries (lib/nav.ts, plus the
+                    lucide-react icon dependency). Automatic in apps made with \`create --blocks\`; off by
+                    default in apps made from a named stack (create apollo, starter, ...), where running it once opts the
+                    app in, so later add calls wire routes without the flag
+Existing files are never overwritten without --force. Installed blocks are
+recorded in graph8.json so re-runs do nothing.`;
+function parseAddArgs(argv) {
+  const o = { spec: "", dir: ".", dryRun: false, force: false, install: true };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    const [flag, inline] = arg.startsWith("--") && arg.includes("=") ? [arg.slice(0, arg.indexOf("=")), arg.slice(arg.indexOf("=") + 1)] : [arg, void 0];
+    const value = () => {
+      const v = inline ?? argv[++i];
+      if (v === void 0 || v.startsWith("--")) throw new Error(`${flag} needs a value
+
+${ADD_USAGE}`);
+      return v;
+    };
+    if (flag === "--dir") o.dir = value();
+    else if (flag === "--target") o.target = value();
+    else if (arg === "--dry-run") o.dryRun = true;
+    else if (arg === "--force") o.force = true;
+    else if (arg === "--no-install") o.install = false;
+    else if (arg === "--routes") o.routes = true;
+    else if (arg.startsWith("-")) throw new Error(`unknown option ${arg}
+
+${ADD_USAGE}`);
+    else if (!o.spec) o.spec = arg;
+    else throw new Error(`unexpected argument ${arg}
+
+${ADD_USAGE}`);
+  }
+  if (!o.spec) throw new Error(`add needs a block name
+
+${ADD_USAGE}`);
+  return o;
+}
+function detectPackageManager(root) {
+  const has = (f) => import_node_fs4.default.existsSync(import_node_path5.default.join(root, f));
+  if (has("pnpm-lock.yaml")) return "pnpm";
+  if (has("yarn.lock")) return "yarn";
+  if (has("bun.lockb") || has("bun.lock")) return "bun";
+  return "npm";
+}
+function installCommand(pm, packages) {
+  const verb = pm === "npm" ? "install" : "add";
+  return { cmd: pm, args: [verb, ...packages] };
+}
+var sha = (s) => (0, import_node_crypto.createHash)("sha256").update(s).digest("hex");
+function appTargeted(block) {
+  const m = /* @__PURE__ */ new Map();
+  for (const f of block.server) if (f.target && !f.target.startsWith("g8/")) m.set(posix(f.file), f.target);
+  return m;
+}
+function listFiles(dir, base = dir) {
+  const out = [];
+  for (const e of import_node_fs4.default.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+    const full = import_node_path5.default.join(dir, e.name);
+    if (e.isDirectory()) out.push(...listFiles(full, base));
+    else out.push(posix(import_node_path5.default.relative(base, full)));
+  }
+  return out;
+}
+var IMPORT_RE = /(\bfrom\s*|\bimport\s*\(?\s*|\brequire\s*\(\s*)(["'])([^"'\n]+)\2/g;
+function relSpec(fromDir, toFile) {
+  const noExt = toFile;
+  let r = posix(import_node_path5.default.relative(fromDir, noExt));
+  if (!r.startsWith(".")) r = `./${r}`;
+  return r;
+}
+function g8AliasTarget(spec, ctx) {
+  const [seg, ...rest] = spec.split("/");
+  const reserved = ["components", "hooks", "lib", "server", "recipes"].includes(seg);
+  const owner = rest.length && !reserved ? ctx.reg.blocks.find((b) => b.id === seg || b.dir === seg) : void 0;
+  const block = owner ?? ctx.reg.blocks.find((b) => b.id === "foundation");
+  const sub = owner ? rest.join("/") : spec;
+  return import_node_path5.default.join(ctx.targetAbs, block?.dir ?? "_foundation", installedRel(sub) ?? sub);
+}
+function rewriteImports(content, ctx) {
+  return content.replace(IMPORT_RE, (whole, pre, q, spec) => {
+    if (spec.startsWith("@/g8/")) {
+      return `${pre}${q}${relSpec(ctx.destDir, g8AliasTarget(spec.slice("@/g8/".length), ctx))}${q}`;
+    }
+    if (spec.startsWith(".") && ctx.block && ctx.srcFile) {
+      const abs = import_node_path5.default.resolve(import_node_path5.default.dirname(ctx.srcFile), spec);
+      const relInBlock = import_node_path5.default.relative(ctx.block.root, abs);
+      if (relInBlock.startsWith("..")) return whole;
+      const mapped = installedRel(relInBlock);
+      if (mapped === null) return whole;
+      return `${pre}${q}${relSpec(ctx.destDir, import_node_path5.default.join(ctx.targetAbs, ctx.block.dir, mapped))}${q}`;
+    }
+    return whole;
+  });
+}
+function diffSummary(before, after) {
+  const count = (s) => {
+    const m = /* @__PURE__ */ new Map();
+    for (const l of s.split("\n")) m.set(l, (m.get(l) ?? 0) + 1);
+    return m;
+  };
+  const a = count(before);
+  const b = count(after);
+  let removed = 0;
+  let added = 0;
+  for (const [l, n] of a) removed += Math.max(0, n - (b.get(l) ?? 0));
+  for (const [l, n] of b) added += Math.max(0, n - (a.get(l) ?? 0));
+  return `+${added} -${removed} lines vs the template`;
+}
+function classify(abs, rel, content, force) {
+  if (!import_node_fs4.default.existsSync(abs)) return { rel, content, action: "create" };
+  const current = import_node_fs4.default.readFileSync(abs, "utf8");
+  if (current === content) return { rel, content, action: "unchanged" };
+  if (force) return { rel, content, action: "update", detail: diffSummary(current, content) };
+  return { rel, content, action: "skip", detail: `exists and differs (${diffSummary(current, content)}); use --force to overwrite` };
+}
+function readPkg(root) {
+  try {
+    return JSON.parse(import_node_fs4.default.readFileSync(import_node_path5.default.join(root, "package.json"), "utf8"));
+  } catch {
+    return null;
+  }
+}
+function missingPeers(blocks, pkg) {
+  const have = /* @__PURE__ */ new Set([
+    ...Object.keys(pkg.dependencies ?? {}),
+    ...Object.keys(pkg.devDependencies ?? {}),
+    ...Object.keys(pkg.peerDependencies ?? {}),
+    ...Object.keys(pkg.optionalDependencies ?? {})
+  ]);
+  const want = /* @__PURE__ */ new Map();
+  for (const b of blocks) for (const [name, range] of Object.entries(b.peerDependencies)) if (!want.has(name)) want.set(name, range);
+  return [...want].filter(([name]) => !have.has(name)).map(([name, range]) => `${name}@${range}`);
+}
+function parseSpec(spec) {
+  const [blockId, component, ...extra] = spec.split("/");
+  if (!blockId || extra.length) throw new Error(`invalid block "${spec}": use <block> or <block>/<Component>`);
+  return { blockId, component: component || void 0 };
+}
+function planBlock(block, only, reg, targetAbs, root, force) {
+  const skipComponentFiles = /* @__PURE__ */ new Set();
+  if (only) {
+    for (const c of block.components) if (c.name !== only) skipComponentFiles.add(posix(c.file));
+    const byStem = new Map(block.components.map((c) => [posix(c.file).replace(/\.[tj]sx?$/, ""), posix(c.file)]));
+    const start = block.components.find((c) => c.name === only);
+    const queue = start ? [posix(start.file)] : [];
+    while (queue.length) {
+      const file = queue.pop();
+      const text = import_node_fs4.default.readFileSync(import_node_path5.default.join(block.root, file), "utf8");
+      for (const m of text.matchAll(IMPORT_RE)) {
+        if (!m[3].startsWith(".")) continue;
+        const stem = posix(import_node_path5.default.relative(block.root, import_node_path5.default.resolve(block.root, import_node_path5.default.dirname(file), m[3]))).replace(/\.[tj]sx?$/, "");
+        const sibling = byStem.get(stem);
+        if (sibling && skipComponentFiles.delete(sibling)) queue.push(sibling);
+      }
+    }
+  }
+  const files = [];
+  const toApp = appTargeted(block);
+  for (const rel of listFiles(block.root)) {
+    if (skipComponentFiles.has(rel) || toApp.has(rel)) continue;
+    const mapped = installedRel(rel);
+    if (mapped === null) continue;
+    const destAbs = import_node_path5.default.join(targetAbs, block.dir, mapped);
+    const src = import_node_path5.default.join(block.root, rel);
+    const text = import_node_fs4.default.readFileSync(src, "utf8");
+    const content = rewriteImports(text, { reg, targetAbs, block, srcFile: src, destDir: import_node_path5.default.dirname(destAbs) });
+    files.push(classify(destAbs, posix(import_node_path5.default.relative(root, destAbs)), content, force));
+  }
+  return files;
+}
+var PROXY_CONTRACT = [
+  "This is not a Next.js project, so the proxy route was not written. Your server must provide the same contract:",
+  "  - handle every method on /api/g8/* (the browser calls these paths)",
+  "  - forward to ${G8_API_URL:-https://be.graph8.com}/api/v1/<rest of path>, same method, query and body",
+  "  - add the header `Authorization: Bearer $G8_API_KEY` on the server; never send the key to the browser",
+  "  - return the upstream status and JSON body unchanged"
+];
+function writeFile(root, f) {
+  const abs = import_node_path5.default.join(root, f.rel);
+  import_node_fs4.default.mkdirSync(import_node_path5.default.dirname(abs), { recursive: true });
+  import_node_fs4.default.writeFileSync(abs, f.content, "utf8");
+}
+function readLedger(file) {
+  try {
+    const j = JSON.parse(import_node_fs4.default.readFileSync(file, "utf8"));
+    return j && typeof j === "object" && j.blocks ? j : null;
+  } catch {
+    return null;
+  }
+}
+function ledgerContent(prev, target, entries, only, wired) {
+  const blocks = { ...prev?.blocks ?? {} };
+  for (const [id, files] of entries) {
+    const old = blocks[id];
+    const recorded = { ...old?.files ?? {} };
+    for (const f of files) {
+      if (f.action === "skip") continue;
+      recorded[f.rel] = sha(f.content);
+    }
+    const comp = only.get(id);
+    let components;
+    if (!comp) components = "all";
+    else if (old?.components === "all") components = "all";
+    else components = [.../* @__PURE__ */ new Set([...old?.components ?? [], comp])].sort();
+    blocks[id] = { files: Object.fromEntries(Object.entries(recorded).sort(([a], [b]) => a.localeCompare(b))), components };
+  }
+  const sorted = Object.fromEntries(Object.entries(blocks).sort(([a], [b]) => a.localeCompare(b)));
+  const stack = prev?.stack ? { stack: prev.stack } : {};
+  const app = appRecord(prev, wired);
+  return `${JSON.stringify({ sdkVersion: SDK_VERSION, target, ...stack, ...app ? { app } : {}, blocks: sorted }, null, 2)}
+`;
+}
+function appRecord(prev, wired) {
+  if (!wired?.screens.length) return prev?.app;
+  const old = prev?.app ?? {};
+  const blocks = [.../* @__PURE__ */ new Set([...old.blocks ?? [], wired.requested])];
+  return { ...old, blocks, screens: [...old.screens ?? [], ...wired.screens] };
+}
+function ensureEnvExample(root, dryRun, out) {
+  const file = import_node_path5.default.join(root, ".env.local.example");
+  const current = import_node_fs4.default.existsSync(file) ? import_node_fs4.default.readFileSync(file, "utf8") : null;
+  if (current !== null && /^G8_API_KEY=/m.test(current)) {
+    out("keep .env.local.example  (G8_API_KEY already listed)");
+    return;
+  }
+  out(`${dryRun ? "would " : ""}${current === null ? "create" : "update"} .env.local.example  (+ G8_API_KEY=)`);
+  if (dryRun) return;
+  const base = current === null ? "" : current.endsWith("\n") || current === "" ? current : `${current}
+`;
+  import_node_fs4.default.writeFileSync(file, `${base}G8_API_KEY=
+`, "utf8");
+}
+function runAdd(opts, reg, io, cwd) {
+  const root = import_node_path5.default.resolve(cwd, opts.dir);
+  const pkg = readPkg(root);
+  if (!pkg) {
+    io.err(`no package.json in ${root}. Run this from your app's root, or pass --dir.`);
+    return 1;
+  }
+  let parsed;
+  let blocks;
+  try {
+    parsed = parseSpec(opts.spec);
+    blocks = resolveWithDeps(reg, [parsed.blockId]);
+    const main2 = blocks[blocks.length - 1];
+    if (parsed.component && !main2.components.some((c) => c.name === parsed.component)) {
+      const names = main2.components.map((c) => c.name).join(", ") || "none";
+      throw new Error(`block "${main2.id}" has no component "${parsed.component}" (available: ${names})`);
+    }
+  } catch (e) {
+    io.err(e.message);
+    return 1;
+  }
+  const exists = (p) => import_node_fs4.default.existsSync(import_node_path5.default.join(root, p));
+  const target = opts.target ?? (exists("src") && !exists("components") && !exists("app") ? "src/components/g8" : "components/g8");
+  const targetAbs = import_node_path5.default.resolve(root, target);
+  const isNext = Boolean(pkg.dependencies?.next ?? pkg.devDependencies?.next);
+  const dry = opts.dryRun;
+  const verb = (a) => a === "unchanged" ? "keep" : a === "skip" ? "skip" : dry ? `would ${a}` : a;
+  const entries = /* @__PURE__ */ new Map();
+  const only = /* @__PURE__ */ new Map();
+  const main = blocks[blocks.length - 1];
+  for (const b of blocks) {
+    const comp = b === main ? parsed.component : void 0;
+    only.set(b.id, comp);
+    entries.set(b.id, planBlock(b, comp, reg, targetAbs, root, opts.force));
+  }
+  const all = [...entries.values()].flat();
+  const prevLedger = readLedger(import_node_path5.default.join(root, "graph8.json"));
+  const route = planAppFiles(blocks, reg, targetAbs, root, isNext, opts.force, installedBlocks(reg, prevLedger, blocks));
+  const wiring = opts.wireScreens !== false && !parsed.component && isNext ? screenWiring(blocks, prevLedger, opts.routes === true, reg, root, posix(import_node_path5.default.relative(root, targetAbs)), io) : null;
+  io.out(`${dry ? "Dry run: " : ""}adding ${blocks.map((b) => b.id).join(" + ")} to ${target}`);
+  for (const f of [...all, ...route.files]) io.out(`${verb(f.action)} ${f.rel}${f.detail ? `  (${f.detail})` : ""}`);
+  if (route.note) route.note.forEach((l) => io.out(l));
+  for (const f of wiring?.files ?? []) io.out(`${verb(f.action)} ${f.rel}`);
+  wiring?.notes.forEach((l) => io.out(l));
+  if (!dry) {
+    for (const f of [...all, ...route.files, ...wiring?.files ?? []]) if (f.action === "create" || f.action === "update") writeFile(root, f);
+  }
+  ensureEnvExample(root, dry, io.out);
+  const ledgerPath = import_node_path5.default.join(root, "graph8.json");
+  const next = ledgerContent(prevLedger, posix(import_node_path5.default.relative(root, targetAbs)), entries, only, wiring ? { requested: main.id, screens: wiring.screens } : void 0);
+  const prevText = import_node_fs4.default.existsSync(ledgerPath) ? import_node_fs4.default.readFileSync(ledgerPath, "utf8") : null;
+  if (next !== prevText) {
+    io.out(`${dry ? "would " : ""}${prevText === null ? "create" : "update"} graph8.json`);
+    if (!dry) import_node_fs4.default.writeFileSync(ledgerPath, next, "utf8");
+  } else io.out("keep graph8.json");
+  return installPeers(blocks, pkg, root, opts, io, wiring?.usesIcons ? lucidePeer(io) : []);
+}
+function screenWiring(blocks, prev, routes, reg, root, target, io) {
+  if (!prev?.app && !(routes && prev?.stack)) return null;
+  if (!io.templatesRoot) return null;
+  const fresh = blocks.filter((b) => !prev.blocks[b.id]);
+  if (!fresh.length) return null;
+  return planScreenWiring({ reg, root, target, stackId: prev.stack ?? "custom", blocks: fresh, templatesRoot: io.templatesRoot, recorded: prev.app?.screens ?? [] });
+}
+function lucidePeer(io) {
+  try {
+    const sdk = JSON.parse(import_node_fs4.default.readFileSync(io.sdkPackageJson ?? "", "utf8"));
+    return [`lucide-react@${sdk.peerDependencies?.["lucide-react"] ?? ">=0.400.0"}`];
+  } catch {
+    return ["lucide-react@>=0.400.0"];
+  }
+}
+function installPeers(blocks, pkg, root, opts, io, extra = []) {
+  const have = new Set(missingPeers(blocks, pkg).map((m) => m.slice(0, m.lastIndexOf("@"))));
+  const declared = new Set(Object.keys({ ...pkg.dependencies, ...pkg.devDependencies, ...pkg.peerDependencies, ...pkg.optionalDependencies }));
+  const missing = [...missingPeers(blocks, pkg), ...extra.filter((e) => !declared.has(e.slice(0, e.lastIndexOf("@"))) && !have.has(e.slice(0, e.lastIndexOf("@"))))];
+  if (!missing.length) return 0;
+  const pm = detectPackageManager(root);
+  const { cmd, args } = installCommand(pm, missing);
+  const shown = `${cmd} ${args.join(" ")}`;
+  if (!opts.install || opts.dryRun) {
+    io.out(`${opts.dryRun ? "would run" : "not installing (--no-install). Run"}: ${shown}`);
+    return 0;
+  }
+  io.out(`installing peer dependencies: ${shown}`);
+  const code = io.spawn(cmd, args, root);
+  if (code !== 0) {
+    io.err(`peer dependency install failed (exit ${code}). Run it yourself: ${shown}`);
+    return 1;
+  }
+  return 0;
+}
+function appTargetPath(root, target) {
+  const useSrc = import_node_fs4.default.existsSync(import_node_path5.default.join(root, "src", "app")) && !import_node_fs4.default.existsSync(import_node_path5.default.join(root, "app"));
+  return useSrc && target.startsWith("app/") ? `src/${target}` : target;
+}
+function installedBlocks(reg, prev, adding) {
+  const ids = /* @__PURE__ */ new Set([...Object.keys(prev?.blocks ?? {}), ...adding.map((b) => b.id)]);
+  return reg.blocks.filter((b) => ids.has(b.id));
+}
+function planPrefixedRoute(destAbs, rel, template, prefixes, force) {
+  const fresh = applyPrefixes(template, prefixes) ?? template;
+  if (!import_node_fs4.default.existsSync(destAbs)) return { rel, content: fresh, action: "create", detail: `allowedPrefixes: ${prefixes.length} API areas from the installed blocks` };
+  const current = import_node_fs4.default.readFileSync(destAbs, "utf8");
+  const regenerated = hasPrefixRegion(current) ? applyPrefixes(current, prefixes) : null;
+  if (regenerated !== null && !force) {
+    if (regenerated === current) return { rel, content: current, action: "unchanged" };
+    return { rel, content: regenerated, action: "update", detail: `allowedPrefixes regenerated: ${prefixes.length} API areas` };
+  }
+  const planned = classify(destAbs, rel, fresh, force);
+  if (planned.action === "skip") planned.detail = `${planned.detail}; its allowedPrefixes are yours: \`npx @graph8/sdk doctor --fix-prefixes\` prints the list the blocks need`;
+  return planned;
+}
+function planAppFiles(blocks, reg, targetAbs, root, isNext, force, installed = blocks) {
+  const files = [];
+  let skipped = false;
+  for (const b of blocks) {
+    for (const [file, target] of appTargeted(b)) {
+      if (!isNext) {
+        skipped = true;
+        continue;
+      }
+      const destAbs = import_node_path5.default.join(root, appTargetPath(root, target));
+      const src = import_node_path5.default.join(b.root, file);
+      const content = rewriteImports(import_node_fs4.default.readFileSync(src, "utf8"), { reg, targetAbs, destDir: import_node_path5.default.dirname(destAbs) });
+      const rel = posix(import_node_path5.default.relative(root, destAbs));
+      if (hasPrefixRegion(content)) files.push(planPrefixedRoute(destAbs, rel, content, derivePrefixes(installed), force));
+      else files.push(classify(destAbs, rel, content, force));
+    }
+  }
+  return { files, note: skipped ? PROXY_CONTRACT : void 0 };
+}
+
+// src/blocks/brand.ts
+var import_node_fs5 = __toESM(require("fs"));
+var import_node_path6 = __toESM(require("path"));
+function normalizeHex(input) {
+  const m = /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(input.trim());
+  if (!m) return null;
+  const h = m[1].length === 3 ? [...m[1]].map((c) => c + c).join("") : m[1];
+  return `#${h.toLowerCase()}`;
+}
+function hexToRgb(hex) {
+  const h = (normalizeHex(hex) ?? "#000000").slice(1);
+  return [0, 2, 4].map((i) => parseInt(h.slice(i, i + 2), 16));
+}
+function rgbToHex([r, g, b]) {
+  return `#${[r, g, b].map((v) => Math.round(Math.min(255, Math.max(0, v))).toString(16).padStart(2, "0")).join("")}`;
+}
+function luminance(hex) {
+  const [r, g, b] = hexToRgb(hex).map((v) => {
+    const c = v / 255;
+    return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+  });
+  return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+function contrast(a, b) {
+  const [hi, lo] = [luminance(a), luminance(b)].sort((x, y) => y - x);
+  return (hi + 0.05) / (lo + 0.05);
+}
+function mix(hex, toward, amount) {
+  const a = hexToRgb(hex);
+  const b = hexToRgb(toward);
+  return rgbToHex([0, 1, 2].map((i) => a[i] + (b[i] - a[i]) * amount));
+}
+var CANVAS = { light: "#ffffff", dark: "#111110" };
+var INK = { light: "#16140f", dark: "#f2efe9" };
+var AA_TEXT = 4.5;
+var AA_UI = 3;
+var STEPS = [
+  ["50", "#ffffff", 0.94],
+  ["100", "#ffffff", 0.86],
+  ["200", "#ffffff", 0.7],
+  ["300", "#ffffff", 0.5],
+  ["400", "#ffffff", 0.25],
+  ["600", "#000000", 0.14],
+  ["700", "#000000", 0.28],
+  ["800", "#000000", 0.42],
+  ["900", "#000000", 0.56]
+];
+function scaleOf(brand) {
+  const out = {};
+  for (const [k, to, amt] of STEPS) out[k] = mix(brand, to, amt);
+  out["500"] = brand;
+  return Object.fromEntries(Object.entries(out).sort(([a], [b]) => Number(a) - Number(b)));
+}
+function bestForeground(bg, ink) {
+  return [ink, "#ffffff", "#000000"].sort((a, b) => contrast(b, bg) - contrast(a, bg))[0];
+}
+function swatch(input, mode, explicit, notes) {
+  let brand = input;
+  const canvas = CANVAS[mode];
+  if (mode === "dark" && !explicit) {
+    for (let i = 1; i <= 20 && contrast(brand, canvas) < AA_UI; i++) brand = mix(input, "#ffffff", i * 0.05);
+    if (brand !== input) notes.push(`dark mode: lightened ${input} to ${brand} so it stands out from the dark background (${contrast(brand, canvas).toFixed(2)}:1)`);
+  }
+  let fg = bestForeground(brand, INK[mode]);
+  for (let i = 1; i <= 20 && contrast(fg, brand) < AA_TEXT; i++) {
+    const before = brand;
+    brand = mix(brand, luminance(fg) > 0.5 ? "#000000" : "#ffffff", 0.05);
+    fg = bestForeground(brand, INK[mode]);
+    if (i === 1) notes.push(`${mode} mode: adjusted ${before} for readable button text`);
+  }
+  const canvasContrast = contrast(brand, canvas);
+  if (canvasContrast < AA_UI) {
+    notes.push(
+      `${mode} mode: ${brand} is faint against the ${mode} background (${canvasContrast.toFixed(2)}:1, under ${AA_UI}:1); button text stays readable, but consider a deeper colour${mode === "dark" ? " or --dark-brand-color" : ""}`
+    );
+  }
+  return { brand, foreground: fg, scale: scaleOf(brand), canvasContrast };
+}
+function brandTheme(color, darkColor) {
+  const light = normalizeHex(color);
+  if (!light) throw new Error(`--brand-color must be a hex colour like #0f62fe (got "${color}")`);
+  const dark = darkColor === void 0 ? light : normalizeHex(darkColor);
+  if (!dark) throw new Error(`--dark-brand-color must be a hex colour like #78a9ff (got "${darkColor}")`);
+  const notes = [];
+  return { light: swatch(light, "light", true, notes), dark: swatch(dark, "dark", darkColor !== void 0, notes), notes };
+}
+var CSS_START = "/* graph8:brand:start */";
+var CSS_END = "/* graph8:brand:end */";
+function vars(s, indent) {
+  const lines = [
+    `--brand: ${s.brand};`,
+    `--brand-foreground: ${s.foreground};`,
+    ...Object.entries(s.scale).map(([k, v]) => `--brand-${k}: ${v};`),
+    "--primary: var(--brand);",
+    "--primary-foreground: var(--brand-foreground);",
+    "--ring: color-mix(in srgb, var(--brand) 45%, transparent);"
+  ];
+  return lines.map((l) => `${indent}${l}`).join("\n");
+}
+function brandCss(theme, source) {
+  return [
+    CSS_START,
+    `/* Generated by \`npx @graph8/sdk brand --brand-color ${source.color}${source.dark ? ` --dark-brand-color ${source.dark}` : ""}\`. Re-run it to change`,
+    "   the colour; edits inside these markers are replaced. Text on --brand meets WCAG AA (4.5:1). */",
+    "@theme inline {",
+    "  --color-brand: var(--brand);",
+    "  --color-brand-foreground: var(--brand-foreground);",
+    ...Object.keys(theme.light.scale).map((k) => `  --color-brand-${k}: var(--brand-${k});`),
+    "}",
+    ":root {",
+    vars(theme.light, "  "),
+    "}",
+    ".dark {",
+    vars(theme.dark, "  "),
+    "}",
+    CSS_END
+  ].join("\n");
+}
+function applyCssRegion(css, region) {
+  const a = css.indexOf(CSS_START);
+  const b = a >= 0 ? css.indexOf(CSS_END, a) : -1;
+  if (a >= 0 && b > a) return `${css.slice(0, a)}${region}${css.slice(b + CSS_END.length)}`;
+  return `${css.replace(/\s*$/, "")}
+
+${region}
+`;
+}
+var DEFAULT_FIELDS = { appUrl: "https://app.graph8.com", linkLabel: "graph8" };
+var CONFIG_FILE = "g8.config.ts";
+var CFG_START = "// graph8:brand:start";
+var CFG_END = "// graph8:brand:end";
+function renderBrandConfig(f) {
+  return [
+    "/**",
+    " * This app's brand. The app shell shows `name` and `logo`; every graph8 block reads `linkLabel` and `appUrl`",
+    ' * (through <BrandProvider>) for its copy and link-outs ("Connect in graph8", "Open in graph8"), so a white-label',
+    " * app can name its own platform and link to its own URL. Fields left out keep graph8's defaults.",
+    " *",
+    ' * Change it with `npx @graph8/sdk brand --name "Acme" --brand-color "#0f62fe" --logo ./logo.svg`',
+    " * (also --app-url, --link-label, --dark-brand-color), or edit the values below. The CLI rewrites only the",
+    " * lines between the graph8:brand markers.",
+    " */",
+    configRegion(f),
+    ""
+  ].join("\n");
+}
+function configRegion(f) {
+  return [
+    CFG_START,
+    "export const brand: { name: string; appUrl: string; linkLabel: string; logo?: string } = {",
+    `  name: ${JSON.stringify(f.name)},`,
+    `  appUrl: ${JSON.stringify(f.appUrl)},`,
+    `  linkLabel: ${JSON.stringify(f.linkLabel)},`,
+    ...f.logo ? [`  logo: ${JSON.stringify(f.logo)},`] : [],
+    "};",
+    CFG_END
+  ].join("\n");
+}
+function readBrandConfig(source) {
+  const a = source.indexOf(CFG_START);
+  const b = a >= 0 ? source.indexOf(CFG_END, a) : -1;
+  if (a < 0 || b < 0) return null;
+  const region = source.slice(a, b);
+  const out = {};
+  for (const key of ["name", "appUrl", "linkLabel", "logo"]) {
+    const m = new RegExp(`^\\s*${key}:\\s*("(?:[^"\\\\]|\\\\.)*")`, "m").exec(region);
+    if (m) {
+      try {
+        out[key] = JSON.parse(m[1]);
+      } catch {
+      }
+    }
+  }
+  return out;
+}
+function applyBrandConfig(source, f) {
+  const a = source.indexOf(CFG_START);
+  const b = a >= 0 ? source.indexOf(CFG_END, a) : -1;
+  if (a < 0 || b < 0) return null;
+  return `${source.slice(0, a)}${configRegion(f)}${source.slice(b + CFG_END.length)}`;
+}
+var BRAND_USAGE = `Usage: npx @graph8/sdk brand [options]
+
+Brand an app made by \`create\` (run it in the app's root). Every option is optional; values you leave out stay.
+  --name <text>              the app's name (sidebar, page title)
+  --brand-color <hex>        primary colour, e.g. "#0f62fe": writes --brand, a 50-900 scale and --primary into
+                             app/globals.css, with button text checked for WCAG AA (adjusted when needed)
+  --dark-brand-color <hex>   the colour in dark mode (default: derived from --brand-color, lightened if too dark)
+  --logo <path>              an svg, png, jpg, webp or gif (max 512 KB), copied to public/brand/ and shown in the sidebar
+  --app-url <url>            white-label: where link-outs go (default https://app.graph8.com)
+  --link-label <text>        white-label: what the platform is called in copy and links (default graph8)
+  --dir <path>               the app's root (default: current directory)
+  --dry-run                  print what would change, write nothing
+Running it again with the same options changes nothing.`;
+function takeBrandFlag(o, flag, next) {
+  if (flag === "--name") o.name = next();
+  else if (flag === "--brand-color") o.color = next();
+  else if (flag === "--dark-brand-color") o.darkColor = next();
+  else if (flag === "--logo") o.logo = next();
+  else if (flag === "--app-url") o.appUrl = next();
+  else if (flag === "--link-label") o.linkLabel = next();
+  else return false;
+  return true;
+}
+function hasBrandInput(o) {
+  return [o.name, o.color, o.darkColor, o.logo, o.appUrl, o.linkLabel].some((v) => v !== void 0);
+}
+function parseBrandArgs(argv) {
+  const o = { dir: "." };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    const eq = arg.startsWith("--") ? arg.indexOf("=") : -1;
+    const flag = eq > 0 ? arg.slice(0, eq) : arg;
+    const next = () => {
+      const v = eq > 0 ? arg.slice(eq + 1) : argv[++i];
+      if (v === void 0 || v.startsWith("--") && v !== "--") throw new Error(`${flag} needs a value
+
+${BRAND_USAGE}`);
+      return v;
+    };
+    if (takeBrandFlag(o, flag, next)) continue;
+    if (flag === "--dir") o.dir = next();
+    else if (arg === "--dry-run") o.dryRun = true;
+    else throw new Error(`unknown option ${arg}
+
+${BRAND_USAGE}`);
+  }
+  if (!hasBrandInput(o)) throw new Error(`brand needs at least one of --name, --brand-color, --dark-brand-color, --logo, --app-url, --link-label
+
+${BRAND_USAGE}`);
+  return o;
+}
+var LOGO_TYPES = ["svg", "png", "jpg", "jpeg", "webp", "gif"];
+var MAX_LOGO_BYTES = 512 * 1024;
+function brandProblem(o, cwd) {
+  if (o.name !== void 0 && !o.name.trim()) return "--name cannot be empty";
+  if (o.linkLabel !== void 0 && !o.linkLabel.trim()) return "--link-label cannot be empty";
+  if (o.appUrl !== void 0 && !/^https?:\/\/[^\s/]+[^\s]*$/i.test(o.appUrl)) return `--app-url must be an http(s) URL (got "${o.appUrl}")`;
+  if (o.color !== void 0 && !normalizeHex(o.color)) return `--brand-color must be a hex colour like #0f62fe (got "${o.color}")`;
+  if (o.darkColor !== void 0 && !normalizeHex(o.darkColor)) return `--dark-brand-color must be a hex colour like #78a9ff (got "${o.darkColor}")`;
+  if (o.darkColor !== void 0 && o.color === void 0) return "--dark-brand-color goes with --brand-color (pass both)";
+  if (o.logo !== void 0) {
+    const abs = import_node_path6.default.resolve(cwd, o.logo);
+    const ext = import_node_path6.default.extname(abs).slice(1).toLowerCase();
+    if (!LOGO_TYPES.includes(ext)) return `--logo must be one of ${LOGO_TYPES.join(", ")} (got "${o.logo}")`;
+    if (!import_node_fs5.default.existsSync(abs) || !import_node_fs5.default.statSync(abs).isFile()) return `--logo: no file at ${o.logo}`;
+    if (import_node_fs5.default.statSync(abs).size > MAX_LOGO_BYTES) return `--logo is larger than ${MAX_LOGO_BYTES / 1024} KB: use a smaller (or svg) file`;
+  }
+  return null;
+}
+function cssFile(root) {
+  return ["app/globals.css", "src/app/globals.css"].find((f) => import_node_fs5.default.existsSync(import_node_path6.default.join(root, f))) ?? null;
+}
+function planBrand(o, root, cwd, fallbackName = "graph8 app") {
+  const files = [];
+  const notes = [];
+  const cfgPath = import_node_path6.default.join(root, CONFIG_FILE);
+  const existing = import_node_fs5.default.existsSync(cfgPath) ? import_node_fs5.default.readFileSync(cfgPath, "utf8") : null;
+  const current = existing === null ? {} : readBrandConfig(existing);
+  if (existing !== null && current === null) {
+    throw new Error(`${CONFIG_FILE} has no graph8:brand markers, so it is yours and was not changed. Set the brand there by hand.`);
+  }
+  const fields = {
+    name: o.name?.trim() ?? current?.name ?? fallbackName,
+    appUrl: (o.appUrl ?? current?.appUrl ?? DEFAULT_FIELDS.appUrl).replace(/\/+$/, ""),
+    linkLabel: o.linkLabel?.trim() ?? current?.linkLabel ?? DEFAULT_FIELDS.linkLabel,
+    logo: current?.logo
+  };
+  if (o.logo !== void 0) {
+    const src = import_node_path6.default.resolve(cwd, o.logo);
+    const ext = import_node_path6.default.extname(src).slice(1).toLowerCase().replace("jpeg", "jpg");
+    const rel = `public/brand/logo.${ext}`;
+    files.push({ rel, content: import_node_fs5.default.readFileSync(src) });
+    for (const other of LOGO_TYPES.map((e) => `public/brand/logo.${e}`)) {
+      if (other !== rel && import_node_fs5.default.existsSync(import_node_path6.default.join(root, other))) files.push({ rel: other, content: null, note: "replaced by the new logo" });
+    }
+    fields.logo = `/brand/logo.${ext}`;
+  }
+  const cfg = existing === null ? renderBrandConfig(fields) : applyBrandConfig(existing, fields);
+  files.push({ rel: CONFIG_FILE, content: cfg });
+  if (o.color !== void 0) {
+    const css = cssFile(root);
+    if (!css) throw new Error("no app/globals.css found: run brand in the root of an app made by `graph8-sdk create`, or pass --dir");
+    const theme = brandTheme(o.color, o.darkColor);
+    notes.push(...theme.notes);
+    notes.push(
+      `colours: light ${theme.light.brand} with ${theme.light.foreground} text (${contrast(theme.light.foreground, theme.light.brand).toFixed(2)}:1), dark ${theme.dark.brand} with ${theme.dark.foreground} text (${contrast(theme.dark.foreground, theme.dark.brand).toFixed(2)}:1)`
+    );
+    const region = brandCss(theme, { color: normalizeHex(o.color), dark: o.darkColor ? normalizeHex(o.darkColor) : void 0 });
+    files.push({ rel: css, content: applyCssRegion(import_node_fs5.default.readFileSync(import_node_path6.default.join(root, css), "utf8"), region) });
+  }
+  const shell = ["components/app-shell.tsx", "src/components/app-shell.tsx"].find((f) => import_node_fs5.default.existsSync(import_node_path6.default.join(root, f)));
+  if (shell && !import_node_fs5.default.readFileSync(import_node_path6.default.join(root, shell), "utf8").includes("g8.config")) {
+    notes.push(
+      `${shell} predates branding, so it does not show the name and logo yet: import { brand } from "@/g8.config" there, and wrap its content in <BrandProvider brand={brand}> (components/g8/_foundation/brand-provider) so the blocks pick up linkLabel and appUrl.`
+    );
+  }
+  return { files, notes };
+}
+function same(abs, content) {
+  if (!import_node_fs5.default.existsSync(abs)) return false;
+  const cur = import_node_fs5.default.readFileSync(abs);
+  return Buffer.isBuffer(content) ? cur.equals(content) : cur.toString("utf8") === content;
+}
+function runBrand(o, io, cwd, fallbackName) {
+  const root = import_node_path6.default.resolve(cwd, o.dir);
+  if (!import_node_fs5.default.existsSync(import_node_path6.default.join(root, "package.json"))) {
+    io.err(`no package.json in ${root}. Run this from your app's root, or pass --dir.`);
+    return 1;
+  }
+  const problem = brandProblem(o, cwd);
+  if (problem) return io.err(`${problem}
+
+${BRAND_USAGE}`), 1;
+  let plan;
+  try {
+    plan = planBrand(o, root, cwd, fallbackName ?? import_node_path6.default.basename(root));
+  } catch (e) {
+    io.err(e.message);
+    return 1;
+  }
+  for (const f of plan.files) {
+    const abs = import_node_path6.default.join(root, f.rel);
+    if (f.content === null) {
+      io.out(`${o.dryRun ? "would remove" : "remove"} ${f.rel}${f.note ? `  (${f.note})` : ""}`);
+      if (!o.dryRun) import_node_fs5.default.rmSync(abs, { force: true });
+      continue;
+    }
+    if (same(abs, f.content)) {
+      io.out(`keep ${f.rel}`);
+      continue;
+    }
+    io.out(`${o.dryRun ? "would " : ""}${import_node_fs5.default.existsSync(abs) ? "update" : "create"} ${f.rel}`);
+    if (!o.dryRun) {
+      import_node_fs5.default.mkdirSync(import_node_path6.default.dirname(abs), { recursive: true });
+      import_node_fs5.default.writeFileSync(abs, f.content);
+    }
+  }
+  plan.notes.forEach((n) => io.out(`note: ${n}`));
+  return 0;
+}
+
+// src/blocks/create.ts
+var import_node_fs6 = __toESM(require("fs"));
+var import_node_path7 = __toESM(require("path"));
+var CREATE_USAGE = `Usage: npx @graph8/sdk create <stack> <dir> [options]
+
+Scaffold a Next.js (App Router, TypeScript, Tailwind CSS v4) app for a stack and
+install the stack's blocks into it. Run \`graph8-sdk list\` to see the stacks.
+  --package-manager <npm|pnpm|yarn|bun>   default: the one running the command, else npm
+  --no-install      write the files and blocks, do not install dependencies
+  --dry-run         print what would be written, write and install nothing
+  --force           allow a non-empty <dir> (template files are overwritten, and graph8.json
+                    is reset: blocks you added to that app earlier are no longer recorded)
+Then: \`npm run dev\` in <dir>, open http://localhost:3000 and paste a graph8 API key (local preview), and run
+\`npx @graph8/sdk doctor --stack <stack>\` (add --production before going live).
+
+Or pick the features yourself, for any app (also: \`create custom --blocks ...\`):
+  npx @graph8/sdk create --blocks <id,id,...> [--title "Acme CRM"] <dir> [options]
+Every requested block's dependencies come with it. The app gets one route and one sidebar entry per finished
+Screen of the requested blocks, plus the user-facing Screens of their dependencies (asking for deals also gives
+you crm's screens). \`/\` opens the analytics screen if you asked for one, else the first screen.
+  --title <text>          the app's name (default: graph8 app)
+  --with-deps-screens     also add the plain fallback page of dependency blocks that have no Screen
+  --no-deps-screens       add screens only for the blocks you named
+Run \`graph8-sdk list\` to see each block and which have Screens.
+
+Brand it (any stack or --blocks; the same as running \`graph8-sdk brand\` in the new app afterwards):
+  --name <text>             the app's name (with --blocks, the same as --title)
+  --brand-color <hex>       primary colour, AA-checked; --dark-brand-color <hex> for dark mode
+  --logo <path>             svg/png/jpg/webp/gif, shown in the sidebar
+  --app-url <url>           white-label: where "Open in graph8" links go; --link-label <text>: what they call it
+A directory literally named \`custom\` would read as the alias: pass \`--blocks crm ./custom\`.`;
+var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
+function parseCreateArgs(argv) {
+  const o = { stack: "", dir: "", install: true, dryRun: false, force: false };
+  const positional = [];
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    const eq = arg.startsWith("--") ? arg.indexOf("=") : -1;
+    const [flag, inline] = eq > 0 ? [arg.slice(0, eq), arg.slice(eq + 1)] : [arg, void 0];
+    if (flag === "--package-manager") {
+      const v = inline ?? argv[++i];
+      if (!PACKAGE_MANAGERS.includes(v)) throw new Error(`--package-manager must be one of ${PACKAGE_MANAGERS.join(", ")}
+
+${CREATE_USAGE}`);
+      o.packageManager = v;
+    } else if (flag === "--blocks") {
+      const v = inline ?? argv[++i];
+      if (v === void 0 || v.startsWith("--")) throw new Error(`--blocks needs a comma-separated list of block ids
+
+${CREATE_USAGE}`);
+      o.blocks = [...o.blocks ?? [], ...v.split(",").map((x) => x.trim()).filter(Boolean)];
+    } else if (flag === "--title") {
+      const v = inline ?? argv[++i];
+      if (v === void 0 || v.startsWith("--")) throw new Error(`--title needs a value
+
+${CREATE_USAGE}`);
+      o.title = v;
+    } else if (takeBrandFlag(o.brand ??= {}, flag, () => {
+      const v = inline ?? argv[++i];
+      if (v === void 0 || v.startsWith("--")) throw new Error(`${flag} needs a value
+
+${CREATE_USAGE}`);
+      return v;
+    })) {
+    } else if (arg === "--with-deps-screens") o.depsScreens = "with";
+    else if (arg === "--no-deps-screens") o.depsScreens = "none";
+    else if (arg === "--no-install") o.install = false;
+    else if (arg === "--dry-run") o.dryRun = true;
+    else if (arg === "--force") o.force = true;
+    else if (arg.startsWith("-")) throw new Error(`unknown option ${arg}
+
+${CREATE_USAGE}`);
+    else positional.push(arg);
+  }
+  if (o.brand && !hasBrandInput(o.brand)) delete o.brand;
+  if (o.brand?.name !== void 0 && o.title !== void 0 && o.brand.name !== o.title) throw new Error(`--name and --title name the same thing: pass one
+
+${CREATE_USAGE}`);
+  if (o.blocks || positional[0] === "custom") return parseCustom(o, positional);
+  if (o.title || o.depsScreens) throw new Error(`--title, --with-deps-screens and --no-deps-screens go with --blocks
+
+${CREATE_USAGE}`);
+  if (positional.length !== 2) throw new Error(`create needs a stack and a directory
+
+${CREATE_USAGE}`);
+  [o.stack, o.dir] = positional;
+  return o;
+}
+function parseCustom(o, positional) {
+  const rest = positional[0] === "custom" ? positional.slice(1) : positional;
+  if (!o.blocks?.length) throw new Error(`create custom needs --blocks <id,id,...> (see \`graph8-sdk list\`)
+
+${CREATE_USAGE}`);
+  if (rest.length !== 1) {
+    throw new Error(`${rest.length ? "a stack name cannot be combined with --blocks; pass only the directory" : "create --blocks needs a directory"}
+
+${CREATE_USAGE}`);
+  }
+  return { ...o, stack: "custom", dir: rest[0] };
+}
+function packageManagerFromUserAgent(ua) {
+  const name = /^(npm|pnpm|yarn|bun)\//.exec(ua ?? "")?.[1];
+  return name ?? "npm";
+}
+function appNameFor(dir) {
+  const base = import_node_path7.default.basename(import_node_path7.default.resolve(dir)).toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^[._-]+|-+$/g, "");
+  return base || "g8-app";
+}
+var quoted = (p) => /^[\w@%+=:,./-]+$/.test(p) ? p : JSON.stringify(p);
+function walk(dir, base = dir) {
+  const out = [];
+  for (const e of import_node_fs6.default.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+    const full = import_node_path7.default.join(dir, e.name);
+    if (e.isDirectory()) out.push(...walk(full, base));
+    else out.push(posix(import_node_path7.default.relative(base, full)));
+  }
+  return out;
+}
+function outputName(rel) {
+  const noExt = rel.replace(/\.tmpl$/, "");
+  const dir = import_node_path7.default.posix.dirname(noExt);
+  const base = import_node_path7.default.posix.basename(noExt).replace(/^dot-/, ".");
+  return dir === "." ? base : `${dir}/${base}`;
+}
+function stackProblem(reg, stack) {
+  const { missing } = stackStatus(reg, stack);
+  if (missing.length) {
+    const ready = reg.stacks.filter((s) => !stackStatus(reg, s).missing.length).map((s) => s.id);
+    return [
+      `stack "${stack.id}" is planned: these blocks are not in this version of @graph8/sdk yet: ${missing.join(", ")}.`,
+      `Stacks you can create now: ${ready.join(", ") || "none"}. Or create one of those and add blocks as they ship (\`graph8-sdk add <block>\`).`
+    ].join("\n");
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const homeIssue = homeProblem(stack);
+  if (homeIssue) return homeIssue;
+  for (const n of stack.nav) {
+    const block = findBlock(reg, n.block);
+    if (!stack.blocks.includes(n.block)) return `stack "${stack.id}" nav "${n.label}" uses block "${n.block}" which the stack does not include.`;
+    if (!block?.components.some((c) => c.name === n.component)) return `stack "${stack.id}" nav "${n.label}" uses ${n.component}, which block "${n.block}" does not declare.`;
+    if (/[\[\]]/.test(n.path)) return `stack "${stack.id}" nav "${n.label}" uses ${n.path}: dynamic segments cannot be a sidebar link.`;
+    if (seen.has(n.path)) return `stack "${stack.id}" has two nav entries at ${n.path}.`;
+    seen.add(n.path);
+    if (n.page && (!reg.stacksRoot || !import_node_fs6.default.existsSync(import_node_path7.default.join(reg.stacksRoot, stack.id, n.page)))) {
+      return `stack "${stack.id}" nav "${n.label}" uses page ${n.page}, which does not exist under stacks/${stack.id}/.`;
+    }
+  }
+  return null;
+}
+function homeProblem(stack) {
+  if (!stack.home) return null;
+  if (!stack.nav.some((n) => n.path === stack.home)) return `stack "${stack.id}" has home ${stack.home}, which is not one of its nav paths.`;
+  if (stack.home !== "/" && stack.nav.some((n) => n.path === "/")) return `stack "${stack.id}" has home ${stack.home} but also a nav entry at "/": drop one.`;
+  return null;
+}
+function stackPageFile(reg, stack, n) {
+  return n.page && reg.stacksRoot ? import_node_path7.default.join(reg.stacksRoot, stack.id, n.page) : null;
+}
+function homeRedirect(stack) {
+  if (stack.home) return stack.home === "/" ? null : stack.home;
+  return stack.nav.length && !stack.nav.some((n) => n.path === "/") ? stack.nav[0].path : null;
+}
+function renderPages(reg, stack, templates) {
+  const pageTpl = import_node_fs6.default.readFileSync(import_node_path7.default.join(templates, "_pages", "route-page.tsx.tmpl"), "utf8");
+  const files = stack.nav.map((n) => {
+    const block = findBlock(reg, n.block);
+    const comp = block.components.find((c) => c.name === n.component);
+    const custom = stackPageFile(reg, stack, n);
+    const vars2 = {
+      stackId: stack.id,
+      block: block.id,
+      blockDir: `components/g8/${block.dir}`,
+      component: n.component,
+      importPath: componentImportPath(block, comp.file),
+      propsJson: JSON.stringify(n.props ?? {}, null, 2)
+    };
+    return { rel: pageFileFor(n.path), content: render(custom ? import_node_fs6.default.readFileSync(custom, "utf8") : pageTpl, vars2) };
+  });
+  const to = homeRedirect(stack);
+  if (to) {
+    const redirect = import_node_fs6.default.readFileSync(import_node_path7.default.join(templates, "_pages", "redirect-page.tsx.tmpl"), "utf8");
+    files.push({ rel: "app/page.tsx", content: render(redirect, { firstPathJson: JSON.stringify(to) }) });
+  }
+  return files;
+}
+function peerDependenciesFor(blocks, io, stack) {
+  const peers = {};
+  for (const b of blocks) for (const [name, range] of Object.entries(b.peerDependencies)) peers[name] ??= range;
+  const usesUi = blocks.some((b) => walk(b.root).some((f) => /\.(tsx?|jsx?)$/.test(f) && /["']@graph8\/sdk\/ui["'/]/.test(import_node_fs6.default.readFileSync(import_node_path7.default.join(b.root, f), "utf8"))));
+  if (usesUi && io.sdkPackageJson && import_node_fs6.default.existsSync(io.sdkPackageJson)) {
+    const sdk = JSON.parse(import_node_fs6.default.readFileSync(io.sdkPackageJson, "utf8"));
+    for (const [name, range] of Object.entries(sdk.peerDependencies ?? {})) peers[name] ??= range;
+  }
+  if (navUsesExtras(stack.nav)) peers["lucide-react"] ??= lucideRange(io);
+  return peers;
+}
+function lucideRange(io) {
+  try {
+    const sdk = JSON.parse(import_node_fs6.default.readFileSync(io.sdkPackageJson ?? "", "utf8"));
+    return sdk.peerDependencies?.["lucide-react"] ?? ">=0.400.0";
+  } catch {
+    return ">=0.400.0";
+  }
+}
+function mergedPackageJson(rendered, peers) {
+  const pkg = JSON.parse(rendered);
+  for (const [name, range] of Object.entries(peers)) pkg.dependencies[name] ??= range;
+  pkg.dependencies = Object.fromEntries(Object.entries(pkg.dependencies).sort(([a], [b]) => a.localeCompare(b)));
+  return `${JSON.stringify(pkg, null, 2)}
+`;
+}
+function planCreate(reg, stack, appName, pm, io, app) {
+  const templates = import_node_path7.default.join(io.templatesRoot, "next-app");
+  const blocks = resolveWithDeps(reg, stack.blocks);
+  const devCommand = pm === "npm" ? "npm run dev" : `${pm} dev`;
+  const vars2 = {
+    appName,
+    sdkVersion: SDK_VERSION,
+    stackId: stack.id,
+    title: stack.title,
+    titleJson: JSON.stringify(stack.title),
+    ...navParts(stack),
+    devCommand,
+    installCommand: `${pm} install`,
+    doctorCommand: app ? "npx @graph8/sdk doctor" : `npx @graph8/sdk doctor --stack ${stack.id}`,
+    screens: stack.nav.map((n) => `- ${n.label}: \`${n.path}\` (${n.block} block, \`${n.component}\`)`).join("\n") || "- (none yet: add a block with `npx @graph8/sdk add <block>`)"
+  };
+  const files = [];
+  for (const rel of walk(templates).filter((f) => !f.startsWith("_pages/"))) {
+    let content = render(import_node_fs6.default.readFileSync(import_node_path7.default.join(templates, rel), "utf8"), vars2);
+    if (rel === "package.json.tmpl") content = mergedPackageJson(content, peerDependenciesFor(blocks, io, stack));
+    files.push({ rel: outputName(rel), content });
+  }
+  files.push(...renderPages(reg, stack, templates));
+  files.push({ rel: CONFIG_FILE, content: renderBrandConfig({ name: stack.title, ...DEFAULT_FIELDS }) });
+  const ledger = { sdkVersion: SDK_VERSION, target: "components/g8", stack: stack.id, ...app ? { app } : {}, blocks: {} };
+  files.push({ rel: "graph8.json", content: `${JSON.stringify(ledger, null, 2)}
+` });
+  return files;
+}
+function dirProblem(abs, force) {
+  if (!import_node_fs6.default.existsSync(abs)) return null;
+  if (!import_node_fs6.default.statSync(abs).isDirectory()) return `${abs} exists and is not a directory.`;
+  if (force || import_node_fs6.default.readdirSync(abs).length === 0) return null;
+  return `${abs} is not empty. Pick a new directory, or pass --force to write into it (template files are overwritten).`;
+}
+function runCreate(opts, reg, io, cwd) {
+  let app;
+  let stack = opts.blocks ? void 0 : reg.stacks.find((s) => s.id === opts.stack);
+  if (opts.blocks) {
+    let composed;
+    try {
+      composed = composeApp(reg, opts.blocks, { title: opts.title, withDepsScreens: opts.depsScreens === "with", noDepsScreens: opts.depsScreens === "none" });
+    } catch (e) {
+      io.err(e.message);
+      return 1;
+    }
+    stack = composed.stack;
+    app = { title: stack.title, blocks: [...new Set(opts.blocks)], screens: composed.screens.map((x) => ({ block: x.block, component: x.component, path: x.path })) };
+    composed.warnings.forEach((w) => io.err(`warning: ${w}`));
+  } else if (!stack) {
+    io.err(`unknown stack "${opts.stack}". Stacks: ${reg.stacks.map((s) => s.id).join(", ") || "none"} (\`graph8-sdk list\`).`);
+    return 1;
+  }
+  if (!stack) return 1;
+  const name = opts.brand?.name?.trim();
+  if (name) {
+    stack = { ...stack, title: name };
+    if (app) app = { ...app, title: name };
+  }
+  const problem = stackProblem(reg, stack);
+  if (problem) return io.err(problem), 1;
+  const abs = import_node_path7.default.resolve(cwd, opts.dir);
+  const dirIssue = dirProblem(abs, opts.force);
+  if (dirIssue) return io.err(dirIssue), 1;
+  const brandIssue = opts.brand ? brandProblem(opts.brand, cwd) : null;
+  if (brandIssue) return io.err(brandIssue), 1;
+  const pm = opts.packageManager ?? packageManagerFromUserAgent(io.userAgent);
+  let files;
+  try {
+    files = planCreate(reg, stack, appNameFor(opts.dir), pm, io, app);
+  } catch (e) {
+    io.err(e.message);
+    return 1;
+  }
+  const blocks = resolveWithDeps(reg, stack.blocks);
+  io.out(`${opts.dryRun ? "Dry run: " : ""}creating "${stack.title}" (${app ? `custom: ${app.blocks.join(", ")}` : stack.id}) in ${opts.dir}`);
+  for (const f of files) io.out(`${opts.dryRun ? "would write" : "write"} ${f.rel}`);
+  if (opts.dryRun) {
+    io.out(`would add blocks: ${blocks.map((b) => b.id).join(", ")}`);
+    if (opts.brand) io.out(`would brand the app: ${Object.entries(opts.brand).map(([k, v]) => `${k} ${v}`).join(", ")}`);
+    io.out(opts.install ? `would run: ${pm} install` : "would not install dependencies (--no-install)");
+    return 0;
+  }
+  for (const f of files) {
+    const dest = import_node_path7.default.join(abs, f.rel);
+    import_node_fs6.default.mkdirSync(import_node_path7.default.dirname(dest), { recursive: true });
+    import_node_fs6.default.writeFileSync(dest, f.content, "utf8");
+  }
+  return finish(opts, reg, stack, blocks, abs, pm, io, cwd);
+}
+function finish(opts, reg, stack, blocks, abs, pm, io, cwd) {
+  for (const b of blocks) {
+    const code = runAdd({ spec: b.id, dir: abs, target: "components/g8", dryRun: false, force: opts.force, install: false, wireScreens: false }, reg, io, cwd);
+    if (code !== 0) {
+      io.err(`adding block "${b.id}" failed; the app in ${opts.dir} is incomplete.`);
+      return code;
+    }
+  }
+  if (opts.brand) {
+    io.out("branding the app (graph8-sdk brand)");
+    const code = runBrand({ ...opts.brand, dir: abs }, io, cwd, stack.title);
+    if (code !== 0) {
+      io.err(`branding failed; the app in ${opts.dir} is complete but unbranded. Fix the option and run \`npx @graph8/sdk brand\` in it.`);
+      return code;
+    }
+  }
+  if (opts.install) {
+    io.out(`installing dependencies: ${pm} install`);
+    const code = io.spawn(pm, ["install"], abs);
+    if (code !== 0) {
+      io.err(`dependency install failed (exit ${code}). Run it yourself: cd ${quoted(opts.dir)} && ${pm} install`);
+      return 1;
+    }
+  }
+  const cd = opts.dir === "." ? "" : `cd ${quoted(opts.dir)} && `;
+  io.out(
+    [
+      "",
+      `Done. Next:`,
+      `  1. ${cd}${opts.install ? "" : `${pm} install && `}${pm === "npm" ? "npm run dev" : `${pm} dev`}`,
+      `  2. open http://localhost:3000 and paste a graph8 API key in the Connect graph8 screen (local preview: only`,
+      `     this computer can reach the app's /api/g8 route), or set G8_API_KEY in ${import_node_path7.default.posix.join(opts.dir, ".env.local")}`,
+      `  3. ${cd}npx @graph8/sdk doctor${opts.blocks ? "" : ` --stack ${stack.id}`}   (before going live: add --production)`
+    ].join("\n")
+  );
+  return 0;
+}
+
+// src/blocks/doctor.ts
+var import_node_fs8 = __toESM(require("fs"));
+var import_node_path9 = __toESM(require("path"));
+
+// src/generated/billable.ts
+var BILLABLE_ROUTES = {
+  GET: [
+    "/apps/{app_id}/runtime",
+    "/audience-syncs/{config_id}/runs",
+    "/campaigns/{campaign_id}/dashboard",
+    "/companies/{company_id}/next-best-step",
+    "/contacts/{contact_id}/next-best-step",
+    "/desk/kickoff",
+    "/desk/kickoff/audio",
+    "/radar/competitors/{competitor_id}/discover-pages",
+    "/repos/{repo_id}/scan",
+    "/seo/domains/{domain}/backlinks",
+    "/seo/domains/{domain}/overview",
+    "/voice/campaigns/call-scripts",
+    "/voice/campaigns/email-templates",
+    "/voice/campaigns/templates",
+    "/voice/research/business-data",
+    "/voice/research/competitors",
+    "/voice/research/faq",
+    "/voice/research/keywords",
+    "/voice/research/prospect-company",
+    "/work/routines/{routine_id}/runs"
+  ],
+  PATCH: [
+    "/enrichment/auto-enrichment/configs/{config_id}",
+    "/intent/keywords/{keyword_id}",
+    "/intent/keywords/{keyword_id}/sync-config",
+    "/marketplace/agencies/{slug}",
+    "/marketplace/agencies/{slug}/reps/{sdr_id}",
+    "/marketplace/agencies/{slug}/service-statements/{statement_id}",
+    "/marketplace/applications/{application_id}",
+    "/marketplace/conversations/{conversation_id}/state",
+    "/marketplace/job-posts/{post_id}",
+    "/marketplace/me/meetings/{meeting_id}",
+    "/marketplace/me/messages/{conversation_id}/state",
+    "/marketplace/me/profile",
+    "/marketplace/me/service-statements/{statement_id}",
+    "/marketplace/org/meetings/{meeting_id}",
+    "/radar/competitors/{competitor_id}",
+    "/radar/gaps/{gap_id}",
+    "/research-reports/{report_id}",
+    "/social-listeners/settings",
+    "/social-listeners/{listener_id}"
+  ],
+  POST: [
+    "/accounts/{account_id}/generate-outreach-plan",
+    "/accounts/{account_id}/security-questionnaires",
+    "/accounts/{account_id}/stakeholders/{stakeholder_id}/generate-outreach",
+    "/ad-creatives",
+    "/ad-creatives/batch",
+    "/ad-creatives/concepts",
+    "/ad-creatives/video/clips",
+    "/ad-creatives/video/clips/prompt-enhance",
+    "/ad-creatives/video/clips/{clip_id}/continue",
+    "/ad-creatives/video/clips/{clip_id}/extend",
+    "/ad-creatives/video/clips/{clip_id}/regenerate",
+    "/ad-creatives/{creative_id}/ai-review",
+    "/ad-creatives/{creative_id}/chat-edit",
+    "/ad-creatives/{creative_id}/image-edit-at-point",
+    "/ad-creatives/{creative_id}/persona-lens",
+    "/ad-creatives/{creative_id}/regenerate-copy",
+    "/ad-creatives/{creative_id}/regenerate-image",
+    "/ad-creatives/{creative_id}/retry",
+    "/ad-creatives/{creative_id}/rewrite-field",
+    "/ad-creatives/{creative_id}/size-set",
+    "/agent/chat",
+    "/agent/onboarding/discovery/turn",
+    "/agent/operators/{operator}/approvals/{task_id}/decide",
+    "/agent/sessions/{session_id}/voice",
+    "/agent/work-items",
+    "/app-pages/{page_id}/generate",
+    "/campaigns/generate-ideas",
+    "/campaigns/generate-ideas-async",
+    "/campaigns/recommend-personas",
+    "/campaigns/{campaign_id}/audience-pipeline/accept-filters",
+    "/campaigns/{campaign_id}/audience-pipeline/trigger",
+    "/campaigns/{campaign_id}/documents/{document_id}/regenerate",
+    "/campaigns/{campaign_id}/sequence/steps/{step_id}/generate",
+    "/companies/enrich/bulk",
+    "/companies/enrich/people/bulk",
+    "/companies/enrich/stakeholders/bulk",
+    "/companies/import",
+    "/companies/{company_id}/documents/types/{doc_type}/generate",
+    "/companies/{company_id}/documents/types/{doc_type}/regenerate",
+    "/companies/{company_id}/enrich",
+    "/companies/{company_id}/retry-intelligence",
+    "/companies/{company_id}/retry-synthesis",
+    "/companies/{company_id}/workflows/{workflow_type}/start",
+    "/company-profile/generate",
+    "/company-profile/reindex",
+    "/company-profile/retry",
+    "/contacts/unlock-info",
+    "/contacts/verify-email",
+    "/contacts/verify-email/async",
+    "/contacts/workflow-executions/run",
+    "/contacts/{contact_id}/documents/generate-all",
+    "/contacts/{contact_id}/documents/types/{doc_type}/generate",
+    "/contacts/{contact_id}/documents/types/{doc_type}/regenerate",
+    "/content-workspace/import/crawl",
+    "/content/calendar/ideas/{idea_id}/create-content",
+    "/content/calendar/mine-signals",
+    "/content/calendar/repurpose/ad",
+    "/content/calendar/repurpose/linkedin-post",
+    "/content/grids/{grid_id}/columns/{column_id}/run",
+    "/content/grids/{grid_id}/rows/{row_id}/run/{column_id}",
+    "/content/pages/enrich-seo-bulk",
+    "/content/pages/{page_id}/enrich-seo",
+    "/copilot/chat",
+    "/copilot/landing-page-action",
+    "/copilot/memory/promote",
+    "/customer-success/companies/{company_id}/brief/synthesize",
+    "/deals/{deal_id}/documents/generate-all",
+    "/deals/{deal_id}/documents/types/{doc_type}/generate",
+    "/deals/{deal_id}/documents/types/{doc_type}/regenerate",
+    "/deals/{deal_id}/next-best-step",
+    "/desk/accounts/{account_id}/committee/{contact_id}/find-linkedin",
+    "/desk/accounts/{account_id}/plan/draft",
+    "/desk/ask",
+    "/desk/decisions/{decision_id}/replan",
+    "/desk/email-improve",
+    "/desk/email-score",
+    "/desk/org-settings/plan-stages/run",
+    "/desk/voice-memo",
+    "/dialer/parallel-calls/grading/backfill",
+    "/dialer/sessions/prewarm-voicemails",
+    "/enrichment/ai-formula/generate",
+    "/enrichment/ai-formula/generate-condition",
+    "/enrichment/ai/batch/enrich",
+    "/enrichment/ai/enrich",
+    "/enrichment/ai/qualification/generate-templates",
+    "/enrichment/ai/qualification/run",
+    "/enrichment/auto-enrichment/configs",
+    "/enrichment/enrich",
+    "/enrichment/find-people/configure",
+    "/enrichment/find-people/search-import",
+    "/enrichment/find-people/{config_id}/import",
+    "/enrichment/find-people/{config_id}/preview",
+    "/enrichment/find-people/{config_id}/run",
+    "/enrichment/generate-prompt",
+    "/enrichment/jobs/{job_id}/resume",
+    "/enrichment/list-routing/generate-filter",
+    "/enrichment/lists/{list_id}/pipelines",
+    "/enrichment/lists/{list_id}/pipelines/ai-draft",
+    "/enrichment/lists/{list_id}/pipelines/{pipeline_id}/enabled",
+    "/enrichment/lists/{list_id}/pipelines/{pipeline_id}/runs",
+    "/enrichment/lookup/company",
+    "/enrichment/lookup/person",
+    "/enrichment/person",
+    "/enrichment/record-sync/{entity_type}/run",
+    "/enrichment/verify-email",
+    "/enrichment/waterfall/configs",
+    "/enrichment/waterfall/enrich",
+    "/global-context/generate-all",
+    "/global-context/generate/{doc_type}",
+    "/hiring-signals/aggregators",
+    "/hiring-signals/companies",
+    "/hiring-signals/companies/job-counts",
+    "/hiring-signals/companies/resolve-ids",
+    "/hiring-signals/decision-makers",
+    "/hiring-signals/job-changes/match",
+    "/hiring-signals/jobs",
+    "/hiring-signals/recruiters",
+    "/icps/generate",
+    "/inbox/drafts/generate",
+    "/intelligence/analyze",
+    "/intelligence/retry",
+    "/intent/contacts/metadata",
+    "/intent/keywords/add",
+    "/intent/keywords/auto-seed-proposals",
+    "/intent/keywords/create-from-domain",
+    "/intent/keywords/create-from-search",
+    "/intent/keywords/list",
+    "/intent/keywords/{keyword_id}/companies",
+    "/intent/keywords/{keyword_id}/contacts",
+    "/intent/keywords/{keyword_id}/filters",
+    "/intent/keywords/{keyword_id}/job-resolution",
+    "/intent/keywords/{keyword_id}/sync",
+    "/intent/keywords/{keyword_id}/urls",
+    "/intent/pages-by-domain",
+    "/intent/pages/contacts",
+    "/intent/pages/search",
+    "/intent/pages/visitor-counts",
+    "/intent/pages/visitors",
+    "/landing-pages",
+    "/landing-pages/clone-homepage",
+    "/landing-pages/clone-html",
+    "/landing-pages/clone-url",
+    "/landing-pages/components/extract",
+    "/landing-pages/ensure-base-template",
+    "/landing-pages/{landing_page_id}/ai-review",
+    "/landing-pages/{landing_page_id}/ai-review/fix-with-ai",
+    "/landing-pages/{landing_page_id}/edit",
+    "/landing-pages/{landing_page_id}/edit-element",
+    "/landing-pages/{landing_page_id}/edit-page",
+    "/landing-pages/{landing_page_id}/generate-seo-metadata",
+    "/landing-pages/{landing_page_id}/rewrite-text",
+    "/leads/generate-content/batches",
+    "/leads/{lead_id}/generate-content",
+    "/library/case-studies/backfill",
+    "/lifecycle-contacts/unlock",
+    "/mailboxes/schedule-buy/plans",
+    "/mailboxes/schedule-buy/plans/{plan_id}/resume",
+    "/mailboxes/uncancel",
+    "/mailboxes/{mailbox_id}/health/placement-test",
+    "/marketplace/agencies/{slug}/intake/upload",
+    "/marketplace/agencies/{slug}/reps/{sdr_id}/unlist",
+    "/marketplace/agencies/{slug}/reps/{sdr_id}/video-intro",
+    "/marketplace/agencies/{slug}/service-statements",
+    "/marketplace/agencies/{slug}/service-statements/{statement_id}/line-items",
+    "/marketplace/agencies/{slug}/service-statements/{statement_id}/submit",
+    "/marketplace/commissions/entries",
+    "/marketplace/commissions/entries/{entry_id}/quality",
+    "/marketplace/commissions/entries/{entry_id}/reversals",
+    "/marketplace/commissions/entries/{entry_id}/statement",
+    "/marketplace/commissions/plans",
+    "/marketplace/commissions/plans/{version_id}/activate",
+    "/marketplace/commissions/preview",
+    "/marketplace/conversations/{conversation_id}/read",
+    "/marketplace/job-posts",
+    "/marketplace/job-posts/{post_id}/jd",
+    "/marketplace/me/headshot",
+    "/marketplace/me/invoices",
+    "/marketplace/me/invoices/{invoice_id}/approve",
+    "/marketplace/me/messages/{conversation_id}/read",
+    "/marketplace/me/offers/{hiring_id}/accept",
+    "/marketplace/me/offers/{hiring_id}/reject",
+    "/marketplace/me/payout-account/w8-certify",
+    "/marketplace/me/resume",
+    "/marketplace/me/service-statements",
+    "/marketplace/me/service-statements/{statement_id}/line-items",
+    "/marketplace/me/service-statements/{statement_id}/revise",
+    "/marketplace/me/service-statements/{statement_id}/submit",
+    "/marketplace/me/video-intro",
+    "/marketplace/me/work-certificates",
+    "/marketplace/opportunities/{post_id}/apply",
+    "/marketplace/org/hirings/{hiring_id}/meetings",
+    "/marketplace/org/hirings/{hiring_id}/terminate",
+    "/marketplace/org/hirings/{hiring_id}/withdraw",
+    "/marketplace/org/invoices/{invoice_id}/approve",
+    "/marketplace/org/invoices/{invoice_id}/dispute",
+    "/marketplace/org/service-statements/{statement_id}/approve",
+    "/marketplace/org/service-statements/{statement_id}/line-items",
+    "/marketplace/org/service-statements/{statement_id}/reject",
+    "/marketplace/org/service-statements/{statement_id}/request-changes",
+    "/marketplace/shortlist/export",
+    "/marketplace/talent/{sdr_id}/hire",
+    "/marketplace/talent/{sdr_id}/match/analyze",
+    "/marketplace/talent/{sdr_id}/match/refresh",
+    "/marketplace/terms-acknowledgements/ack-all",
+    "/meeting-transcripts/{transcript_id}/follow-up-draft",
+    "/meeting-transcripts/{transcript_id}/review/regenerate",
+    "/newsletters/templates/clone",
+    "/newsletters/templates/custom",
+    "/newsletters/templates/layout",
+    "/newsletters/{newsletter_id}/issues/{issue_id}/generate",
+    "/newsletters/{newsletter_id}/issues/{issue_id}/rewrite-text",
+    "/newsletters/{newsletter_id}/subscribers/import-audience",
+    "/newsletters/{newsletter_id}/subscribers/verify",
+    "/org-videos/generate",
+    "/org/brand-snapshot/refresh",
+    "/personas/generate",
+    "/phone-numbers/purchase",
+    "/pipelines/suggest",
+    "/placement/tests",
+    "/provider-domains/add-external",
+    "/provider-domains/check-availability",
+    "/provider-domains/checkout-purchase",
+    "/provider-domains/checkout-transfer",
+    "/provider-domains/{domain_id}/auto-warmup",
+    "/provider-domains/{domain_id}/check-propagation",
+    "/provider-domains/{domain_id}/checkout-mailboxes",
+    "/provider-domains/{domain_id}/connect-provider",
+    "/provider-domains/{domain_id}/dns",
+    "/public/enrich/lookup",
+    "/radar/aeo/run",
+    "/radar/competitors",
+    "/radar/competitors/bulk",
+    "/radar/competitors/{competitor_id}/scan",
+    "/radar/gaps/analyze",
+    "/radar/initiatives/measure",
+    "/radar/opportunities/approve-all",
+    "/radar/opportunities/{gap_id}/approve",
+    "/radar/reports",
+    "/radar/scan-all",
+    "/repos/{repo_id}/scan",
+    "/research-reports/generate",
+    "/research-reports/generate-all",
+    "/research-reports/retry",
+    "/research-reports/workflow/resume",
+    "/revenue/stage-docs/{lifecycle_entry_id}/{entity}/backfill",
+    "/scrape/requests",
+    "/search/companies",
+    "/search/companies/save",
+    "/search/contacts",
+    "/search/contacts/save",
+    "/seo/audits",
+    "/seo/keywords/research",
+    "/sequencer/content/email/generate",
+    "/sequencer/content/instructions/improve",
+    "/sequencer/content/linkedin/generate",
+    "/sequencer/templates/steps/generate",
+    "/social-listeners",
+    "/social-listeners/auto-seed/all",
+    "/social-listeners/auto-seed/brand",
+    "/social-listeners/auto-seed/competitors",
+    "/social-listeners/auto-seed/engagement",
+    "/social-listeners/auto-seed/keywords",
+    "/social-listeners/bulk-from-list",
+    "/social-listeners/integrations/x",
+    "/social-listeners/integrations/x/test",
+    "/social-listeners/posts/{post_id}/engagements/add-to-list",
+    "/social-listeners/posts/{post_id}/mark",
+    "/social-listeners/posts/{post_id}/save-contact",
+    "/social-listeners/queries/generate",
+    "/social/posts/generate",
+    "/tam/generate",
+    "/tam/regenerate",
+    "/tasks/{task_id}/start",
+    "/team-members/me/enrich-linkedin",
+    "/team-members/{team_member_id}/enrich-linkedin",
+    "/team-members/{team_member_id}/generate-post",
+    "/teams/auto-compose/suggest",
+    "/voice/agents/{agent_id}/documents/upload",
+    "/voice/call-flow-examples/transcribe",
+    "/voice/call-scripts/generate",
+    "/voice/campaigns/call-scripts",
+    "/voice/campaigns/email-enhancements",
+    "/voice/campaigns/email-spintax",
+    "/voice/campaigns/emails",
+    "/voice/campaigns/linkedin-messages",
+    "/voice/campaigns/onboarding/messages",
+    "/voice/campaigns/onboarding/threads/actions",
+    "/voice/campaigns/voicemails",
+    "/voice/chat-agent/messages",
+    "/voice/collections/{collection_id}/files/paste-text",
+    "/voice/collections/{collection_id}/files/upload",
+    "/voice/collections/{collection_id}/files/upload-multiple",
+    "/voice/collections/{collection_id}/reindex",
+    "/voice/collections/{collection_id}/scrape-sources",
+    "/voice/collections/{collection_id}/scrape-sources/{source_id}/run",
+    "/voice/email-agent/batch",
+    "/voice/email-agent/compose",
+    "/voice/email-agent/draft-reply",
+    "/voice/icp/queries",
+    "/voice/knowledge-base/files/upload",
+    "/voice/receptionist/messages",
+    "/voice/research/company",
+    "/voice/research/org-chart",
+    "/voice/research/prospect-data",
+    "/voice/research/prospect-profile",
+    "/voice/topics/classify",
+    "/voice/twins",
+    "/voice/twins/extract-linkedin",
+    "/voice/video-recordings/upload",
+    "/voice/voice-library/onboarding-voice",
+    "/voice/voice-library/voices",
+    "/voice/worksheets/calculate",
+    "/work/signals/promote",
+    "/workbench/tables/{table_id}/ai/generate-prompt",
+    "/workbench/tables/{table_id}/ai/groups/{group_id}/run",
+    "/workbench/tables/{table_id}/ai/preview",
+    "/workbench/tables/{table_id}/ai/run",
+    "/workbench/tables/{table_id}/ai/run-all",
+    "/workbench/tables/{table_id}/columns/{col_id}/ai/run",
+    "/workbench/tables/{table_id}/find-people/configure",
+    "/workbench/tables/{table_id}/find-people/{config_id}/run",
+    "/workbench/tables/{table_id}/import/search",
+    "/workbench/tables/{table_id}/import/search/research/preview",
+    "/workbench/tables/{table_id}/pipelines",
+    "/workbench/tables/{table_id}/scraper/providers/{provider}/runs",
+    "/workbench/tables/{table_id}/scraper/runs",
+    "/workbench/tables/{table_id}/suggest-mappings",
+    "/workbench/tables/{table_id}/triggers",
+    "/workbench/tables/{table_id}/unlock-rows",
+    "/workbench/tables/{table_id}/waterfall/configs/{column_id}/run"
+  ],
+  PUT: [
+    "/agent/operators/{operator}/enabled",
+    "/agent/operators/{operator}/skills/{skill_key}",
+    "/deliverability/autopilot/preferences",
+    "/enrichment/auto-enrichment/settings/{entity_type}",
+    "/enrichment/lists/{list_id}/pipelines/{pipeline_id}",
+    "/enrichment/record-sync/{entity_type}/policy",
+    "/enrichment/waterfall/configs/{column_id}",
+    "/marketplace/me/invoices/{invoice_id}",
+    "/marketplace/me/rates",
+    "/radar/settings",
+    "/workbench/tables/{table_id}/auto-enrich",
+    "/workbench/tables/{table_id}/pipelines/{pipeline_id}",
+    "/workbench/tables/{table_id}/schedule",
+    "/workbench/tables/{table_id}/triggers/{trigger_id}"
+  ]
+};
+
+// src/generated/external.ts
+var EXTERNAL_ROUTES = {
+  GET: [
+    "/dialer/sessions/token",
+    "/marketplace/me/connect/dashboard-link",
+    "/marketplace/me/connect/onboarding-link",
+    "/marketplace/me/payout-account/login-link",
+    "/marketplace/me/payout-account/onboarding-link",
+    "/voice/mcp-servers/{mcp_server_id}/tools"
+  ],
+  PATCH: [
+    "/ad-campaigns/{campaign_id}/ads/{ad_id}",
+    "/appointments/bookings/{booking_uid}/location",
+    "/appointments/bookings/{booking_uid}/sequence",
+    "/appointments/workflows/{workflow_id}",
+    "/audience-syncs/{config_id}",
+    "/campaigns/{campaign_id}",
+    "/campaigns/{campaign_id}/full",
+    "/content/calendar/{content_type}/{content_id}/schedule",
+    "/inbox/mailboxes/bulk",
+    "/inbox/mailboxes/{mailbox}/settings",
+    "/integrations/crm/meetings/{event_id}",
+    "/newsletters/{newsletter_id}/subscribers/{subscriber_id}/unsubscribe",
+    "/quotes/{quote_id}",
+    "/sequences/{sequence_id}",
+    "/sequences/{sequence_id}/steps/{step_id}",
+    "/voice/dialer/sessions/{session_id}/status",
+    "/voice/dispositions/{disposition_id}",
+    "/webhooks/{webhook_id}"
+  ],
+  POST: [
+    "/ad-campaigns/images",
+    "/ad-campaigns/status-refresh",
+    "/ad-campaigns/{campaign_id}/ads",
+    "/ad-campaigns/{campaign_id}/ads/batch",
+    "/ad-campaigns/{campaign_id}/ads/{ad_id}/status",
+    "/ad-campaigns/{campaign_id}/edit-preview",
+    "/ad-campaigns/{campaign_id}/retry",
+    "/ad-campaigns/{campaign_id}/status-refresh",
+    "/appointments/bookings",
+    "/appointments/bookings/import",
+    "/appointments/bookings/{booking_uid}/confirm",
+    "/appointments/bookings/{booking_uid}/guests",
+    "/appointments/bookings/{booking_uid}/mark-absent",
+    "/appointments/bookings/{booking_uid}/notes",
+    "/appointments/bookings/{booking_uid}/request-reschedule",
+    "/appointments/bookings/{booking_uid}/reschedule",
+    "/appointments/calendars/selected",
+    "/appointments/conferencing/connect/{provider}",
+    "/appointments/conferencing/{provider}/default",
+    "/appointments/workflows",
+    "/appointments/workflows/{workflow_id}/toggle",
+    "/audience-syncs",
+    "/audience-syncs/google/conversion-actions",
+    "/audience-syncs/google/conversions",
+    "/audience-syncs/google/video-assets/library",
+    "/audience-syncs/google/video-assets/links",
+    "/audience-syncs/google/video-assets/upload-urls",
+    "/audience-syncs/google/video-assets/uploads",
+    "/audience-syncs/{config_id}/launch",
+    "/audience-syncs/{config_id}/trigger",
+    "/campaigns",
+    "/campaigns/{campaign_id}/ad-images/{image_id}/hide",
+    "/campaigns/{campaign_id}/documents",
+    "/campaigns/{campaign_id}/launch",
+    "/campaigns/{campaign_id}/sequence/steps",
+    "/content/calendar/{content_type}/{content_id}/retry-publish",
+    "/crm-syncs/{provider}/companies/push",
+    "/crm-syncs/{provider}/contacts/push",
+    "/crm-syncs/{provider}/lists/push",
+    "/customer-success/companies/{company_id}/sync",
+    "/desk/accounts/{account_id}/committee/plays/{action_id}/run",
+    "/desk/accounts/{account_id}/committee/{contact_id}/linkedin-invite",
+    "/desk/decisions/{decision_id}/plays/{action_id}/run",
+    "/desk/decisions/{decision_id}/send-reply",
+    "/desk/decisions/{decision_id}/send-sms",
+    "/desk/plays/approvals/{execution_id}/decide",
+    "/dialer/parallel-calls/calls/{livekit_room_name}/drop-voicemail",
+    "/dialer/parallel-calls/manual-dial",
+    "/dialer/parallel-calls/redial-contact",
+    "/dialer/parallel-calls/sessions/start",
+    "/dialer/sessions/calls/drop-voicemail",
+    "/dialer/sessions/{session_id}/next-batch",
+    "/envelopes/{envelope_id}/resend",
+    "/envelopes/{envelope_id}/send",
+    "/feedback/sending-domains/verify",
+    "/feedback/surveys/{survey_id}/send",
+    "/forms/deliveries/{receipt_id}/retry",
+    "/forms/{form_key}/backfills",
+    "/forms/{form_key}/delivery/pause",
+    "/forms/{form_key}/delivery/resume",
+    "/inbox/emails/compose",
+    "/inbox/emails/{email_id}/send",
+    "/inbox/linkedin/accounts/sync",
+    "/inbox/linkedin/accounts/{account_id}/enable",
+    "/inbox/linkedin/compose",
+    "/inbox/mailboxes/activate",
+    "/inbox/mailboxes/{mailbox}/sync",
+    "/inbox/sms/compose",
+    "/inbox/{reply_id}/assign",
+    "/inbox/{reply_id}/send",
+    "/inbox/{reply_id}/tag",
+    "/integrations/connections",
+    "/integrations/connections/session-token",
+    "/integrations/crm-sync/audiences",
+    "/integrations/crm-sync/contacts/pull",
+    "/integrations/crm-sync/contacts/push",
+    "/integrations/crm-sync/deals/pull",
+    "/integrations/crm-sync/deals/push",
+    "/integrations/crm-sync/leads/previews",
+    "/integrations/crm-sync/leads/pull",
+    "/integrations/crm-sync/leads/push",
+    "/integrations/crm-sync/pull",
+    "/integrations/crm-sync/push",
+    "/integrations/crm/connections/{connection_id}/batch/contacts",
+    "/integrations/crm/connections/{connection_id}/companies",
+    "/integrations/crm/connections/{connection_id}/contacts",
+    "/integrations/crm/connections/{connection_id}/deals",
+    "/integrations/crm/connections/{connection_id}/leads",
+    "/integrations/crm/lists",
+    "/integrations/crm/lists/memberships",
+    "/integrations/crm/meetings",
+    "/integrations/linkedin-outreach/campaigns/{campaign_id}/pause",
+    "/integrations/linkedin-outreach/campaigns/{campaign_id}/resume",
+    "/integrations/linkedin-outreach/connection/reconnect",
+    "/integrations/linkedin-outreach/lists",
+    "/integrations/linkedin-outreach/lists/{list_id}/leads",
+    "/integrations/linkedin-outreach/workspaces/sync",
+    "/integrations/migrations/delta-sync",
+    "/integrations/migrations/discovery",
+    "/integrations/migrations/{migration_id}/confirm",
+    "/integrations/sugarcrm/connect",
+    "/integrations/sugarcrm/reconnect",
+    "/landing-pages/{landing_page_id}/publish",
+    "/landing-pages/{landing_page_id}/unpublish",
+    "/linkedin/accounts/sync",
+    "/marketplace/agencies/{slug}/reps/{sdr_id}/publish",
+    "/marketplace/me/messages/{conversation_id}/reply",
+    "/marketplace/me/payout-account/bank-details",
+    "/marketplace/me/payout-account/methods",
+    "/marketplace/me/payout-account/setup",
+    "/marketplace/me/sync-workbench",
+    "/marketplace/talent/{sdr_id}/messages",
+    "/marketplace/talent/{sdr_id}/request",
+    "/newsletters",
+    "/newsletters/{newsletter_id}/activate",
+    "/newsletters/{newsletter_id}/issues",
+    "/newsletters/{newsletter_id}/issues/{issue_id}/duplicate",
+    "/newsletters/{newsletter_id}/issues/{issue_id}/send",
+    "/newsletters/{newsletter_id}/issues/{issue_id}/send-test",
+    "/newsletters/{newsletter_id}/issues/{issue_id}/send/resume",
+    "/newsletters/{newsletter_id}/resume",
+    "/newsletters/{newsletter_id}/settings/verify-domain",
+    "/newsletters/{newsletter_id}/subscribers",
+    "/nurtures/{nurture_id}/launch",
+    "/org/sso/sync",
+    "/phone-numbers/a2p/register",
+    "/profile/deal-automations/sync-now",
+    "/programmatic-campaigns/{campaign_id}/pages/actions",
+    "/programmatic-campaigns/{campaign_id}/pages/{page_id}/actions",
+    "/provider-domains/{domain_id}/forwarding",
+    "/provider-domains/{domain_id}/mailbox-profile-picture",
+    "/provider-domains/{domain_id}/regenerate-nameservers",
+    "/provider-domains/{domain_id}/resend-transfer-password",
+    "/provider-domains/{domain_id}/resend-verification",
+    "/provider-domains/{domain_id}/set-nameservers",
+    "/provider-usage/refresh",
+    "/provider-usage/sync",
+    "/quote-billing-contact",
+    "/quote-contacts",
+    "/quote-settings/documents",
+    "/quote-templates",
+    "/quotes",
+    "/quotes/batch",
+    "/quotes/{quote_id}/duplicate",
+    "/quotes/{quote_id}/edit-as-draft",
+    "/quotes/{quote_id}/mark-accepted",
+    "/quotes/{quote_id}/send",
+    "/quotes/{quote_id}/unarchive",
+    "/radar/alerts/dispatch",
+    "/repos/{repo_id}/campaigns/{campaign_id}/launch",
+    "/roles/invite",
+    "/sales-coach/interviews/{interview_id}/members",
+    "/sales-coach/interviews/{interview_id}/members/{member_id}/send-invite",
+    "/sequencer/content/voice/test-call",
+    "/sequences",
+    "/sequences/generate-spintax",
+    "/sequences/{sequence_id}/contacts",
+    "/sequences/{sequence_id}/contacts/{contact_id}/resume",
+    "/sequences/{sequence_id}/pause",
+    "/sequences/{sequence_id}/resume",
+    "/sequences/{sequence_id}/run",
+    "/sequences/{sequence_id}/sync",
+    "/settings/scrape-config/crawl",
+    "/skills/{action_id}/execute",
+    "/skills/{action_id}/test-runs",
+    "/social-listeners/posts/{post_id}/add-to-sequence",
+    "/social/posts/{post_id}/engagers/add-to-audience",
+    "/social/posts/{post_id}/engagers/enroll",
+    "/social/posts/{post_id}/publish",
+    "/social/posts/{post_id}/schedule",
+    "/stripe/api-key",
+    "/stripe/sync",
+    "/team-members/sync",
+    "/voice/calls",
+    "/voice/dialer/sessions",
+    "/voice/dialer/sessions/{session_id}/resume",
+    "/voice/dispositions",
+    "/voice/inbound-calls/decline",
+    "/voice/inbound-calls/dialer/{call_id}/decline",
+    "/voice/inbound-calls/{room_name}/claim",
+    "/voice/mcp-servers/{mcp_server_id}/test",
+    "/webhooks",
+    "/webhooks/{webhook_id}/rotate-secret",
+    "/website-editor/publish",
+    "/website-editor/sync",
+    "/workbench/scraper/providers/{provider}/connection/test",
+    "/workbench/tables/{table_id}/import/crm",
+    "/workbench/tables/{table_id}/send-to-sequence",
+    "/workflows",
+    "/workflows/executions/approve",
+    "/workflows/executions/bulk-restart",
+    "/workflows/executions/request-changes",
+    "/workflows/executions/{execution_id}/pause",
+    "/workflows/executions/{execution_id}/restart",
+    "/workflows/executions/{execution_id}/resume",
+    "/workflows/executions/{execution_id}/stop",
+    "/workflows/integrations/{provider_name}/test",
+    "/workflows/validate",
+    "/workflows/workbenches",
+    "/workflows/{action_id}/execute",
+    "/workflows/{action_id}/trigger-reset"
+  ],
+  PUT: [
+    "/ad-campaigns/{campaign_id}",
+    "/appointments/calendars/destination",
+    "/appointments/conferencing/{provider}/link",
+    "/campaigns/{campaign_id}/audience",
+    "/campaigns/{campaign_id}/documents/{document_id}",
+    "/campaigns/{campaign_id}/sequence",
+    "/campaigns/{campaign_id}/sequence/steps/{step_id}",
+    "/desk/autonomy",
+    "/desk/org-settings",
+    "/inbox/linkedin/accounts/{account_id}",
+    "/integrations/crm-sync/pull-enabled",
+    "/integrations/crm-sync/push-enabled",
+    "/integrations/crm/connections/{connection_id}/batch/contacts",
+    "/integrations/crm/connections/{connection_id}/companies/{company_id}",
+    "/integrations/crm/connections/{connection_id}/contacts/{contact_id}",
+    "/integrations/crm/connections/{connection_id}/deals/{deal_id}",
+    "/integrations/crm/connections/{connection_id}/leads/{lead_id}",
+    "/integrations/linkedin-outreach/workspaces/active",
+    "/linkedin/accounts/{account_id}/schedule",
+    "/newsletters/{newsletter_id}/issues/{issue_id}",
+    "/quote-settings",
+    "/quote-templates/{template_id}",
+    "/quotes/{quote_id}",
+    "/sms/phone-numbers/{phone_number}",
+    "/social/autopilot/{account_id}",
+    "/workflows/{action_id}"
+  ]
+};
+
+// src/errors.ts
+var G8ErrorClass = class _G8ErrorClass extends Error {
+  constructor(args) {
+    super(args.message);
+    this.name = "G8Error";
+    this.status = args.status;
+    this.type = args.type;
+    this.code = args.code;
+    this.requestId = args.requestId;
+    this.detail = args.detail;
+    this.retryable = args.retryable ?? false;
+    Object.setPrototypeOf(this, _G8ErrorClass.prototype);
+  }
+};
+var REGISTRY = /* @__PURE__ */ Symbol.for("@graph8/sdk/G8Error");
+var registry = globalThis;
+var G8Error = registry[REGISTRY] ?? (registry[REGISTRY] = G8ErrorClass);
+
+// src/http.ts
+function isRetryableStatus(status) {
+  return status === 429 || status >= 500 && status <= 599;
+}
+function isWriteMethod(method) {
+  const m = method.toUpperCase();
+  return m === "POST" || m === "PUT" || m === "PATCH" || m === "DELETE";
+}
+var API_BASE_SEGMENT = "/api/v1";
+var billableMatchers = null;
+var externalMatchers = null;
+function templateToRegexSource(template) {
+  return template.split(/(\{[^}/]+\})/).map((part) => /^\{[^}/]+\}$/.test(part) ? "[^/]+" : part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("");
+}
+function buildMatchers(routes) {
+  const out = /* @__PURE__ */ new Map();
+  for (const [m, templates] of Object.entries(routes)) {
+    if (!templates.length) continue;
+    out.set(m, new RegExp(`^(?:${templates.map(templateToRegexSource).join("|")})/?$`));
+  }
+  return out;
+}
+function matcherFor(method) {
+  if (!billableMatchers) billableMatchers = buildMatchers(BILLABLE_ROUTES);
+  return billableMatchers.get(method.toUpperCase());
+}
+function externalMatcherFor(method) {
+  if (!externalMatchers) externalMatchers = buildMatchers(EXTERNAL_ROUTES);
+  return externalMatchers.get(method.toUpperCase());
+}
+function apiRelativePath(urlOrPath) {
+  let p = urlOrPath.replace(/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\/[^/]*/, "");
+  p = p.split(/[?#]/, 1)[0];
+  const at = p.indexOf(API_BASE_SEGMENT + "/");
+  if (at < 0) return null;
+  return p.slice(at + API_BASE_SEGMENT.length);
+}
+function isBillableOperation(method, urlOrPath) {
+  const matcher = matcherFor(method);
+  if (!matcher) return false;
+  const p = apiRelativePath(urlOrPath);
+  return p != null && matcher.test(p);
+}
+function isExternalOperation(method, urlOrPath) {
+  const matcher = externalMatcherFor(method);
+  if (!matcher) return false;
+  const p = apiRelativePath(urlOrPath);
+  return p != null && matcher.test(p);
+}
+function isNoBlindRetryOperation(method, urlOrPath) {
+  return isBillableOperation(method, urlOrPath) || isExternalOperation(method, urlOrPath);
+}
+var PRE_SEND_ERROR_CODES = /* @__PURE__ */ new Set([
+  "ECONNREFUSED",
+  "ENOTFOUND",
+  "EAI_AGAIN",
+  "ENETUNREACH",
+  "EHOSTUNREACH",
+  "UND_ERR_CONNECT_TIMEOUT"
+]);
+function isPreSendNetworkError(err) {
+  let cur = err;
+  for (let depth = 0; cur && depth < 4; depth++) {
+    if (typeof cur.code === "string" && PRE_SEND_ERROR_CODES.has(cur.code)) return true;
+    if (Array.isArray(cur.errors) && cur.errors.some((e) => isPreSendNetworkError(e))) return true;
+    cur = cur.cause;
+  }
+  return false;
+}
+function newIdempotencyKey() {
+  const c = globalThis.crypto;
+  if (c?.randomUUID) return c.randomUUID();
+  if (c?.getRandomValues) {
+    const bytes = c.getRandomValues(new Uint8Array(16));
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+  }
+  return `g8-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`;
+}
+function parseRetryAfter(header, nowMs = Date.now()) {
+  if (!header) return null;
+  const secs = Number(header);
+  if (Number.isFinite(secs) && secs >= 0) return Math.round(secs * 1e3);
+  const dateMs = Date.parse(header);
+  if (!Number.isNaN(dateMs)) {
+    const delta = dateMs - nowMs;
+    return delta > 0 ? delta : 0;
+  }
+  return null;
+}
+function backoffDelayMs(attempt, baseMs = 200, rand = Math.random) {
+  const expo = Math.min(baseMs * 2 ** attempt, 1e4);
+  return Math.floor(expo / 2 + rand() * (expo / 2));
+}
+function defaultSleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function buildQuery(query) {
+  if (!query) return "";
+  const qs = new URLSearchParams();
+  for (const [k, v] of Object.entries(query)) {
+    if (v != null) qs.set(k, String(v));
+  }
+  const s = qs.toString();
+  return s ? `?${s}` : "";
+}
+async function toG8Error(resp, retryable = isRetryableStatus(resp.status)) {
+  let body = void 0;
+  try {
+    const text = await resp.text();
+    body = text ? JSON.parse(text) : void 0;
+  } catch {
+    body = void 0;
+  }
+  const env = body ?? {};
+  const message = typeof env.message === "string" && env.message || typeof env.error === "string" && env.error || `Request failed with status ${resp.status}`;
+  return new G8Error({
+    message,
+    status: resp.status,
+    type: typeof env.type === "string" && env.type || typeof env.error === "string" && env.error || "api_error",
+    code: typeof env.code === "string" ? env.code : String(resp.status),
+    requestId: typeof env.request_id === "string" && env.request_id || resp.headers.get("x-request-id") || void 0,
+    detail: env.detail,
+    retryable
+  });
+}
+var TARGET_ORG_HEADER = "x-target-org-id";
+var nonAgencyKeys = /* @__PURE__ */ new Set();
+var warnedTargetOrgKeys = /* @__PURE__ */ new Set();
+function keyFingerprint(apiKey) {
+  let h = 2166136261;
+  for (let i = 0; i < apiKey.length; i++) {
+    h ^= apiKey.charCodeAt(i);
+    h = Math.imul(h, 16777619) >>> 0;
+  }
+  return `${apiKey.length}:${h.toString(36)}`;
+}
+function warnIfTargetOrgIgnored(apiKey, headers) {
+  if (!Object.keys(headers).some((h) => h.toLowerCase() === TARGET_ORG_HEADER)) return;
+  const fp = keyFingerprint(apiKey);
+  if (!nonAgencyKeys.has(fp) || warnedTargetOrgKeys.has(fp)) return;
+  warnedTargetOrgKeys.add(fp);
+  if (typeof console !== "undefined" && typeof console.warn === "function") {
+    console.warn(
+      "[@graph8/sdk] X-Target-Org-Id is set, but the server reported this API key is not an agency key. The header is ignored for non-agency keys: this call runs against the key's own org. Use an agency key (minted with is_agency=true) to target a client org."
+    );
+  }
+}
+async function request(baseUrl, path11, apiKey, opts = {}) {
+  const {
+    method = "GET",
+    body,
+    headers = {},
+    query,
+    idempotencyKey,
+    maxRetries = 2,
+    retryBaseMs = 200,
+    signal,
+    fetchImpl = fetch,
+    sleepImpl = defaultSleep
+  } = opts;
+  const url = baseUrl.replace(/\/+$/, "") + path11 + buildQuery(query);
+  const finalHeaders = {
+    "Content-Type": "application/json",
+    Authorization: `Bearer ${apiKey}`,
+    ...clientIdentityHeaders(headers),
+    ...headers
+  };
+  warnIfTargetOrgIgnored(apiKey, headers);
+  const effectiveIdempotencyKey = idempotencyKey ?? (maxRetries > 0 && isWriteMethod(method) ? newIdempotencyKey() : void 0);
+  if (effectiveIdempotencyKey) finalHeaders["Idempotency-Key"] = effectiveIdempotencyKey;
+  const billable = isNoBlindRetryOperation(method, url);
+  let attempt = 0;
+  for (; ; ) {
+    let resp;
+    try {
+      resp = await fetchImpl(url, {
+        method,
+        headers: finalHeaders,
+        body: body == null ? void 0 : JSON.stringify(body),
+        signal
+      });
+    } catch (err) {
+      const safeToRetry = !billable || isPreSendNetworkError(err);
+      if (attempt < maxRetries && safeToRetry) {
+        await sleepImpl(backoffDelayMs(attempt, retryBaseMs));
+        attempt++;
+        continue;
+      }
+      throw new G8Error({
+        message: `Network error: ${err?.message ?? "request failed"}`,
+        status: 0,
+        type: "network_error",
+        retryable: safeToRetry
+      });
+    }
+    if (resp.ok) {
+      const text = await resp.text();
+      return text ? JSON.parse(text) : void 0;
+    }
+    const statusRetryable = isRetryableStatus(resp.status) && (!billable || resp.status === 429);
+    if (statusRetryable && attempt < maxRetries) {
+      const retryAfter = parseRetryAfter(resp.headers.get("retry-after"));
+      const delay = retryAfter != null ? retryAfter : backoffDelayMs(attempt, retryBaseMs);
+      await sleepImpl(delay);
+      attempt++;
+      continue;
+    }
+    throw await toG8Error(resp, billable ? statusRetryable : isRetryableStatus(resp.status));
+  }
+}
+function isServerRuntime() {
+  const g = globalThis;
+  if (typeof g.window !== "undefined") return false;
+  return typeof g.process?.versions?.node === "string";
+}
+function runtimeUserAgent() {
+  const g = globalThis;
+  const node = typeof g.process?.version === "string" ? ` node/${g.process.version.replace(/^v/, "")}` : "";
+  return `graph8-sdk-js/${SDK_VERSION}${node}`;
+}
+function clientIdentityHeaders(callerHeaders = {}) {
+  const taken = new Set(Object.keys(callerHeaders).map((h) => h.toLowerCase()));
+  const out = {};
+  if (!taken.has("x-g8-client")) out["X-G8-Client"] = SDK_CLIENT_ID;
+  if (!taken.has("user-agent") && isServerRuntime()) out["User-Agent"] = runtimeUserAgent();
+  return out;
+}
+async function* paginate(fetchPage) {
+  let cursor = void 0;
+  for (; ; ) {
+    const page = await fetchPage(cursor);
+    for (const item of page.data ?? []) yield item;
+    const next = page.pagination?.next_cursor;
+    if (!next) break;
+    cursor = next;
+  }
+}
 
 // src/api.ts
 var DEFAULT_API = "https://be.graph8.com";
@@ -5173,15 +6108,95 @@ function createApiClient(apiKey, apiUrl) {
   return client;
 }
 
+// src/blocks/flows.ts
+var import_node_fs7 = __toESM(require("fs"));
+var import_node_path8 = __toESM(require("path"));
+var IMPORT_RE2 = /(?:^|\n)\s*(?:import|export)\s[^'"`;]*?from\s*["']([^"']+)["']|(?:^|\n)\s*import\s*["']([^"']+)["']|import\(\s*["']([^"']+)["']\s*\)/g;
+var EXTENSIONS = ["", ".tsx", ".ts", "/index.tsx", "/index.ts"];
+function specifiers(source) {
+  return [...source.matchAll(IMPORT_RE2)].map((m) => m[1] ?? m[2] ?? m[3]);
+}
+function resolveFile(base) {
+  for (const ext of EXTENSIONS) {
+    const candidate = base + ext;
+    if (import_node_fs7.default.existsSync(candidate) && import_node_fs7.default.statSync(candidate).isFile()) return candidate;
+  }
+  return null;
+}
+function resolveImport(spec, from, reg) {
+  if (spec.startsWith(".")) return resolveFile(import_node_path8.default.resolve(import_node_path8.default.dirname(from), spec));
+  const g8 = /^@\/g8\/([^/]+)\/(.+)$/.exec(spec);
+  if (!g8) return null;
+  const owner = findBlock(reg, g8[1]);
+  if (owner) return resolveFile(import_node_path8.default.join(owner.root, "components", g8[2])) ?? resolveFile(import_node_path8.default.join(owner.root, g8[2]));
+  const foundation = findBlock(reg, "foundation");
+  return foundation ? resolveFile(import_node_path8.default.join(foundation.root, g8[1], g8[2])) : null;
+}
+function resolveInstalled(spec, reg) {
+  const m = /^@\/components\/g8\/([^/]+)\/(.+)$/.exec(spec);
+  const block = m && reg.blocks.find((b) => b.dir === m[1]);
+  if (!m || !block) return null;
+  const files = [...block.components, ...block.hooks, ...block.lib].map((x) => x.file);
+  const hit = files.find((f) => (installedRel(f) ?? f).replace(/\.(tsx|ts|jsx|js)$/, "") === m[2]);
+  return hit ? import_node_path8.default.join(block.root, hit) : null;
+}
+function seeds(reg, stack) {
+  const out = [];
+  for (const n of stack.nav) {
+    const comp = findBlock(reg, n.block)?.components.find((c) => c.name === n.component);
+    const block = findBlock(reg, n.block);
+    if (!block || !comp) continue;
+    const pageFile = n.page && reg.stacksRoot ? import_node_path8.default.join(reg.stacksRoot, stack.id, n.page) : null;
+    if (!pageFile || !import_node_fs7.default.existsSync(pageFile)) {
+      out.push(import_node_path8.default.join(block.root, comp.file));
+      continue;
+    }
+    const source = import_node_fs7.default.readFileSync(pageFile, "utf8");
+    if (source.includes("{{importPath}}")) out.push(import_node_path8.default.join(block.root, comp.file));
+    for (const spec of specifiers(source)) {
+      const hit = resolveInstalled(spec, reg);
+      if (hit) out.push(hit);
+    }
+  }
+  return out;
+}
+function reachedFiles(reg, stack) {
+  const seen = /* @__PURE__ */ new Set();
+  const queue = seeds(reg, stack);
+  while (queue.length) {
+    const file = queue.pop();
+    if (seen.has(file)) continue;
+    seen.add(file);
+    if (!/\.(tsx?|jsx?)$/.test(file)) continue;
+    for (const spec of specifiers(import_node_fs7.default.readFileSync(file, "utf8"))) {
+      const next = resolveImport(spec, file, reg);
+      if (next && !seen.has(next)) queue.push(next);
+    }
+  }
+  return seen;
+}
+function unreachedComponents(reg, stack) {
+  const reached = reachedFiles(reg, stack);
+  const blocks = resolveWithDeps(reg, stack.blocks).filter((b) => b.id !== "foundation" && stack.blocks.includes(b.id));
+  return blocks.flatMap((b) => b.components.filter((c) => !reached.has(import_node_path8.default.join(b.root, c.file))).map((c) => ({ block: b.id, component: c.name })));
+}
+
 // src/blocks/doctor.ts
-var DOCTOR_USAGE = `Usage: npx @graph8/sdk doctor [--stack <id>] [--blocks a,b] [--dir <path>]
+var DOCTOR_USAGE = `Usage: npx @graph8/sdk doctor [--stack <id>] [--blocks a,b] [--dir <path>] [--strict] [--production] [--fix-prefixes]
 
 Check that this project is ready for graph8 blocks:
   - G8_API_KEY (env or .env.local) is valid
   - the key's scopes cover the blocks you chose
   - the organization's subscription is active
   - a checklist of in-app setup each block needs
+With --stack it also lists "Flows": block components that no page of the stack reaches
+(a warning; --strict makes them fail the run).
 With no --stack/--blocks, the blocks recorded in graph8.json are checked.
+It also reads the proxy route (app/api/g8/[...path]/route.ts) and warns about what is left before going live:
+  --production      fail instead: no \`authorize\` (local preview would be the only gate), no allowedPrefixes,
+                    or a dangerouslyAllow* switch on; and the key must come from the environment
+  --fix-prefixes    rewrite the route's generated allowedPrefixes from the installed blocks (graph8.json), then exit
+                    (no network). A route written before 0.367.0 is upgraded only if its list is still the default.
 Optional G8_API_URL points at a non-default API. Exit code 0 when all checks
 pass, 1 otherwise.`;
 function parseDoctorArgs(argv) {
@@ -5200,6 +6215,9 @@ ${DOCTOR_USAGE}`);
     if (flag === "--stack") o.stack = value();
     else if (flag === "--blocks") o.blocks.push(...value().split(",").map((s) => s.trim()).filter(Boolean));
     else if (flag === "--dir") o.dir = value();
+    else if (arg === "--strict") o.strict = true;
+    else if (arg === "--production") o.production = true;
+    else if (arg === "--fix-prefixes") o.fixPrefixes = true;
     else throw new Error(`unknown option ${arg}
 
 ${DOCTOR_USAGE}`);
@@ -5218,9 +6236,9 @@ function parseEnvFile(text) {
 function readSetting(name, root, env) {
   if (env[name]) return env[name];
   for (const f of [".env.local"]) {
-    const file = import_node_path4.default.join(root, f);
-    if (import_node_fs4.default.existsSync(file)) {
-      const v = parseEnvFile(import_node_fs4.default.readFileSync(file, "utf8"))[name];
+    const file = import_node_path9.default.join(root, f);
+    if (import_node_fs8.default.existsSync(file)) {
+      const v = parseEnvFile(import_node_fs8.default.readFileSync(file, "utf8"))[name];
       if (v) return v;
     }
   }
@@ -5241,7 +6259,7 @@ function selectBlocks(opts, reg, root) {
   }
   if (!ids.length) {
     try {
-      const ledger = JSON.parse(import_node_fs4.default.readFileSync(import_node_path4.default.join(root, "graph8.json"), "utf8"));
+      const ledger = JSON.parse(import_node_fs8.default.readFileSync(import_node_path9.default.join(root, "graph8.json"), "utf8"));
       ids = Object.keys(ledger.blocks ?? {});
     } catch {
       ids = [];
@@ -5255,7 +6273,7 @@ function errorText(e, key) {
   return `${status ? `HTTP ${status}: ` : ""}${msg}`.split(key).join("[redacted]");
 }
 async function runDoctor(opts, reg, io, cwd) {
-  const root = import_node_path4.default.resolve(cwd, opts.dir);
+  const root = import_node_path9.default.resolve(cwd, opts.dir);
   let blocks;
   try {
     blocks = selectBlocks(opts, reg, root);
@@ -5263,15 +6281,20 @@ async function runDoctor(opts, reg, io, cwd) {
     io.err(e.message);
     return 1;
   }
+  if (opts.fixPrefixes) return fixPrefixes(root, blocks, io);
   let failed = false;
   const line = (ok, text) => {
     if (ok === false) failed = true;
     io.out(`${ok === null ? "info" : ok ? "ok  " : "FAIL"}  ${text}`);
   };
   io.out(blocks.length ? `Checking blocks: ${blocks.map((b) => b.id).join(", ")}` : "No blocks selected (use --stack or --blocks); checking the key and subscription only.");
-  const key = readSetting("G8_API_KEY", root, io.env);
+  let key = readSetting("G8_API_KEY", root, io.env);
+  if (!key && !opts.production) {
+    key = readLocalKey(root);
+    if (key) line(null, "using the key pasted in the Connect graph8 screen (.g8/local-key, local preview only)");
+  }
   if (!key) {
-    line(false, "G8_API_KEY is not set (checked the environment and .env.local)");
+    line(false, opts.production ? "G8_API_KEY is not set (production reads it from the environment only; checked the environment and .env.local)" : "G8_API_KEY is not set (checked the environment, .env.local and .g8/local-key)");
   } else {
     const api = createApiClient(key, readSetting("G8_API_URL", root, io.env));
     const call = (op) => api.call(op, void 0, {
@@ -5281,6 +6304,9 @@ async function runDoctor(opts, reg, io, cwd) {
     await checkKey(call, blocks, key, line);
     await checkSubscription(call, key, line);
   }
+  checkRoute(root, blocks, opts.production === true, io.out, line);
+  if (opts.stack) printFlows(opts, reg, io.out, line);
+  else if (!opts.blocks.length) printAppScreens(root, reg, io.out);
   printChecklist(blocks, io.out);
   io.out(failed ? "\nSome checks failed." : "\nAll checks passed.");
   return failed ? 1 : 0;
@@ -5318,6 +6344,33 @@ async function checkSubscription(call, key, line) {
     else line(false, `could not read subscription status (${errorText(e, key)})`);
   }
 }
+function printFlows(opts, reg, out, line) {
+  const stack = reg.stacks.find((s) => s.id === opts.stack);
+  if (!stack) return;
+  const missing = unreachedComponents(reg, stack);
+  out("\nFlows (block components a page of this stack reaches):");
+  if (!missing.length) return line(true, "every component of the stack's blocks is reachable from a page");
+  for (const m of missing) {
+    const text = `(${m.block}) ${m.component} is not reached by any page of "${stack.id}": wire it into a page or a Screen slot`;
+    if (opts.strict) line(false, text);
+    else out(`warn  ${text}`);
+  }
+}
+function printAppScreens(root, reg, out) {
+  let app;
+  try {
+    app = JSON.parse(import_node_fs8.default.readFileSync(import_node_path9.default.join(root, "graph8.json"), "utf8")).app;
+  } catch {
+    return;
+  }
+  if (!app?.blocks?.length) return;
+  const ids = app.blocks.filter((id) => reg.blocks.some((b) => b.id === id));
+  out("\nScreens (what each block of this app gives its users):");
+  for (const id of ids) {
+    const block = reg.blocks.find((b) => b.id === id);
+    if (!hasRealScreen(block)) out(`warn  (${id}) has no finished Screen in this version: the app shows its plain ${composeApp(reg, [id], { noDepsScreens: true }).screens[0]?.component ?? "components"} page. A newer @graph8/sdk ships the finished screen.`);
+  }
+}
 function printChecklist(blocks, out) {
   const items = blocks.flatMap((b) => b.prerequisites.filter((p) => p.where === "app").map((p) => ({ block: b.id, p })));
   if (!items.length) return;
@@ -5327,6 +6380,73 @@ function printChecklist(blocks, out) {
     if (p.verify) out(`        verify: ${p.verify}`);
   }
 }
+function readLocalKey(root) {
+  try {
+    return import_node_fs8.default.readFileSync(import_node_path9.default.join(root, ".g8", "local-key"), "utf8").trim() || void 0;
+  } catch {
+    return void 0;
+  }
+}
+var ROUTE_FILES = ["app/api/g8/[...path]/route.ts", "src/app/api/g8/[...path]/route.ts"];
+function findRoute(root) {
+  return ROUTE_FILES.find((f) => import_node_fs8.default.existsSync(import_node_path9.default.join(root, f))) ?? null;
+}
+function checkRoute(root, blocks, production, out, line) {
+  const rel = findRoute(root);
+  if (!rel) {
+    if (production) line(false, `no proxy route found (${ROUTE_FILES[0]}): run doctor from the app's root or pass --dir`);
+    return;
+  }
+  const facts = inspectRoute(import_node_fs8.default.readFileSync(import_node_path9.default.join(root, rel), "utf8"));
+  out(`
+Proxy route (${rel})${production ? ", production gate" : ""}:`);
+  const problem = (text) => production ? line(false, text) : out(`warn  ${text}`);
+  if (!facts.authorize) {
+    problem(
+      facts.localPreview ? "`authorize` is not set: local preview (this computer, `next dev` only) is the only gate. Set `authorize` before going live; a production build refuses every call until you do" : "`authorize` is not set: the route refuses every call until you set it (check your app's session)"
+    );
+  } else line(true, "`authorize` is set");
+  if (facts.dangerouslyAllowUnauthenticated) problem("dangerouslyAllowUnauthenticated is on: anyone who can reach the route can use the key");
+  if (facts.dangerouslyAllowAllPaths) problem("dangerouslyAllowAllPaths is on: every /api/v1 area is reachable from the browser");
+  const need = derivePrefixes(blocks);
+  if (facts.prefixes === void 0) {
+    problem(`allowedPrefixes is not set${need.length ? `: \`npx @graph8/sdk doctor --fix-prefixes\` writes the ${need.length} areas the blocks use` : ""}`);
+  } else if (facts.prefixes === "custom") {
+    out("info  allowedPrefixes is not a literal list; it was not compared with the blocks");
+  } else {
+    const missing = need.filter((p) => !facts.prefixes.includes(p));
+    const extra = facts.prefixes.filter((p) => !need.includes(p));
+    if (!missing.length && !extra.length) line(true, `allowedPrefixes match the installed blocks (${need.length} areas)`);
+    if (missing.length) out(`warn  allowedPrefixes lacks areas the installed blocks call: ${missing.join(", ")} (\`npx @graph8/sdk doctor --fix-prefixes\`)`);
+    if (extra.length && blocks.length) out(`warn  allowedPrefixes allows areas no installed block declares: ${extra.join(", ")}`);
+  }
+}
+function fixPrefixes(root, blocks, io) {
+  const rel = findRoute(root);
+  if (!rel) {
+    io.err(`no proxy route found (${ROUTE_FILES.join(" or ")}). Run this in the app's root or pass --dir.`);
+    return 1;
+  }
+  if (!blocks.length) {
+    io.err("no blocks found: graph8.json lists none (or pass --blocks / --stack).");
+    return 1;
+  }
+  const file = import_node_path9.default.join(root, rel);
+  const source = import_node_fs8.default.readFileSync(file, "utf8");
+  const prefixes = derivePrefixes(blocks);
+  const next = applyPrefixes(source, prefixes) ?? upgradeLegacyRoute(source, prefixes);
+  if (next === null) {
+    io.err(`${rel} has no generated allowedPrefixes region and its list is not the default, so it is yours. The installed blocks need:`);
+    io.err(`const allowedPrefixes = ${formatPrefixes(prefixes)};`);
+    return 1;
+  }
+  if (next === source) io.out(`keep ${rel}  (allowedPrefixes already match the ${prefixes.length} areas of the installed blocks)`);
+  else {
+    import_node_fs8.default.writeFileSync(file, next, "utf8");
+    io.out(`update ${rel}  (allowedPrefixes: ${prefixes.join(", ")})`);
+  }
+  return 0;
+}
 
 // src/cli.ts
 var LIST_USAGE = `Usage: npx @graph8/sdk list [--json]
@@ -5342,14 +6462,16 @@ Commands:
   list         list the blocks and stacks this package ships
   search       find a block by what it does
   add          copy a block (components, hooks, recipes) into your app
-  create       scaffold a Next.js app for a stack (create apollo my-app)
+  create       scaffold a Next.js app: from a stack (create apollo my-app) or from the blocks you pick
+               (create --blocks crm,deals,inbox my-app)
   doctor       check your key, scopes, subscription and setup for the blocks you use
+  brand        give an app its name, colour and logo, and white-label its graph8 links
 
 Run a command with --help for its options.
 
 ${INIT_AGENT_USAGE}`;
 function registryFor(io) {
-  const root = io.blocksRoot ?? process.env.G8_BLOCKS_DIR ?? import_node_path5.default.resolve(__dirname, "..", "blocks");
+  const root = io.blocksRoot ?? process.env.G8_BLOCKS_DIR ?? import_node_path10.default.resolve(__dirname, "..", "blocks");
   return loadRegistry(root);
 }
 function defaultSpawn(cmd, args, cwd) {
@@ -5362,6 +6484,7 @@ function printCatalog(blocks, stacks, io, empty) {
   if (blocks.length) io.out("Blocks");
   for (const b of blocks) {
     io.out(`  ${b.id}  ${b.summary}`);
+    if (b.screens?.length) io.out(`      screens (start here): ${b.screens.join(", ")}`);
     if (b.dependsOn.length) io.out(`      depends on: ${b.dependsOn.join(", ")}`);
   }
   if (stacks.length) io.out(`${blocks.length ? "\n" : ""}Stacks`);
@@ -5371,6 +6494,7 @@ function printCatalog(blocks, stacks, io, empty) {
     if (s.missingBlocks?.length) io.out(`      planned (cannot be created yet), missing blocks: ${s.missingBlocks.join(", ")}`);
   }
 }
+var BUILD_HINT = "To build an app: npx @graph8/sdk create --blocks <ids> <dir>   (every block's finished Screens become routes and sidebar entries)";
 function wantsHelp(rest) {
   return rest.includes("--help") || rest.includes("-h");
 }
@@ -5388,38 +6512,46 @@ ${LIST_USAGE}`);
   const blocks = reg.blocks.map(blockSummary);
   const stacks = reg.stacks.map((s) => stackSummary(s, reg));
   if (rest.includes("--json")) io.out(JSON.stringify({ blocks, stacks }, null, 2));
-  else printCatalog(blocks, stacks, io, "No blocks or stacks are included in this package version.");
+  else {
+    if (blocks.length) io.out(`${BUILD_HINT}
+`);
+    printCatalog(blocks, stacks, io, "No blocks or stacks are included in this package version.");
+  }
   return 0;
 }
 function runSearch(rest, io) {
   if (wantsHelp(rest)) return io.out(SEARCH_USAGE), 0;
-  const words = rest.filter((a) => a !== "--json");
-  const bad = words.find((a) => a.startsWith("-"));
+  const words2 = rest.filter((a) => a !== "--json");
+  const bad = words2.find((a) => a.startsWith("-"));
   if (bad) return fail(io, `unknown option ${bad}
 
 ${SEARCH_USAGE}`);
-  if (!words.length) return fail(io, `search needs some text
+  if (!words2.length) return fail(io, `search needs some text
 
 ${SEARCH_USAGE}`);
   const reg = registryFor(io);
-  const text = words.join(" ");
+  const text = words2.join(" ");
   const blocks = searchBlocks(reg, text).map(blockSummary);
   const stacks = searchStacks(reg, text).map((s) => stackSummary(s, reg));
   if (rest.includes("--json")) io.out(JSON.stringify({ query: text, blocks, stacks }, null, 2));
-  else printCatalog(blocks, stacks, io, `Nothing matches "${text}". Run \`graph8-sdk list\` to see everything.`);
+  else {
+    if (blocks.length) io.out(`${BUILD_HINT}
+`);
+    printCatalog(blocks, stacks, io, `Nothing matches "${text}". Run \`graph8-sdk list\` to see everything.`);
+  }
   return 0;
 }
 function runCreateCommand(rest, io) {
   if (wantsHelp(rest)) return io.out(CREATE_USAGE), 0;
   try {
     const opts = parseCreateArgs(rest);
-    const packageRoot = import_node_path5.default.resolve(__dirname, "..");
+    const packageRoot = import_node_path10.default.resolve(__dirname, "..");
     const cio = {
       out: io.out,
       err: io.err,
       spawn: io.spawn ?? defaultSpawn,
-      templatesRoot: io.templatesRoot ?? process.env.G8_TEMPLATES_DIR ?? import_node_path5.default.join(packageRoot, "templates"),
-      sdkPackageJson: import_node_path5.default.join(packageRoot, "package.json"),
+      templatesRoot: io.templatesRoot ?? process.env.G8_TEMPLATES_DIR ?? import_node_path10.default.join(packageRoot, "templates"),
+      sdkPackageJson: import_node_path10.default.join(packageRoot, "package.json"),
       userAgent: io.userAgent ?? process.env.npm_config_user_agent
     };
     return runCreate(opts, registryFor(io), cio, io.cwd);
@@ -5431,7 +6563,15 @@ function runAddCommand(rest, io) {
   if (wantsHelp(rest)) return io.out(ADD_USAGE), 0;
   try {
     const opts = parseAddArgs(rest);
-    return runAdd(opts, registryFor(io), { out: io.out, err: io.err, spawn: io.spawn ?? defaultSpawn }, io.cwd);
+    const packageRoot = import_node_path10.default.resolve(__dirname, "..");
+    const aio = {
+      out: io.out,
+      err: io.err,
+      spawn: io.spawn ?? defaultSpawn,
+      templatesRoot: io.templatesRoot ?? process.env.G8_TEMPLATES_DIR ?? import_node_path10.default.join(packageRoot, "templates"),
+      sdkPackageJson: import_node_path10.default.join(packageRoot, "package.json")
+    };
+    return runAdd(opts, registryFor(io), aio, io.cwd);
   } catch (e) {
     return fail(io, e.message);
   }
@@ -5446,6 +6586,14 @@ function runCli(argv, io) {
   if (command === "search") return runSearch(rest, io);
   if (command === "add") return runAddCommand(rest, io);
   if (command === "create") return runCreateCommand(rest, io);
+  if (command === "brand") {
+    if (wantsHelp(rest)) return io.out(BRAND_USAGE), 0;
+    try {
+      return runBrand(parseBrandArgs(rest), { out: io.out, err: io.err }, io.cwd);
+    } catch (e) {
+      return fail(io, e.message);
+    }
+  }
   if (command === "doctor") return fail(io, "doctor makes network calls; run it through runCliAsync (the graph8-sdk bin does).");
   if (command !== "init-agent") {
     io.err(`unknown command ${command}
@@ -5465,8 +6613,8 @@ ${USAGE}`);
     return 1;
   }
   const read = (rel) => {
-    const full = import_node_path5.default.join(io.cwd, rel);
-    return import_node_fs5.default.existsSync(full) ? import_node_fs5.default.readFileSync(full, "utf8") : null;
+    const full = import_node_path10.default.join(io.cwd, rel);
+    return import_node_fs9.default.existsSync(full) ? import_node_fs9.default.readFileSync(full, "utf8") : null;
   };
   let plans;
   try {
@@ -5477,9 +6625,9 @@ ${USAGE}`);
   }
   for (const plan of plans) {
     if (!options.dryRun && plan.action !== "unchanged") {
-      const full = import_node_path5.default.join(io.cwd, plan.path);
-      import_node_fs5.default.mkdirSync(import_node_path5.default.dirname(full), { recursive: true });
-      import_node_fs5.default.writeFileSync(full, plan.content, "utf8");
+      const full = import_node_path10.default.join(io.cwd, plan.path);
+      import_node_fs9.default.mkdirSync(import_node_path10.default.dirname(full), { recursive: true });
+      import_node_fs9.default.writeFileSync(full, plan.content, "utf8");
     }
     io.out(`${options.dryRun ? "would " : ""}${plan.action === "unchanged" ? "keep" : plan.action} ${plan.path}  (${plan.target})`);
   }