claude-use 11.41.0 → 11.42.0

package/dist/cli.cjs

@@ -27528,6 +27528,9 @@ function pruneDeadFrontDoorDirectRecords(fs26, recordsDir, records, liveness) {
     }
   }
 }
+function recordOf(details) {
+  return details === void 0 ? {} : { sessionId: details.sessionId, ...details.models === void 0 ? {} : { models: details.models } };
+}
 function writeFrontDoorSession(fs26, sessionsDir, session) {
   fs26.mkdirPrivate(sessionsDir);
   fs26.writeFilePrivate(import_node_path5.default.join(sessionsDir, `${String(session.pid)}.json`), `${JSON.stringify(session, null, 2)}
@@ -27580,14 +27583,31 @@ function liveSessionTokens(fs26, sessionsDir) {
   }
   return tokens;
 }
+function readFrontDoorSessionModels(fs26, sessionsDir, sessionId) {
+  for (const name of fs26.readdir(sessionsDir)) {
+    if (!name.endsWith(".json")) {
+      continue;
+    }
+    try {
+      const parsed = FrontDoorSessionSchema.safeParse(JSON.parse(fs26.readFileUtf8(import_node_path5.default.join(sessionsDir, name)) ?? ""));
+      if (parsed.success && parsed.data.sessionId === sessionId) {
+        return parsed.data.models;
+      }
+    } catch {
+      continue;
+    }
+  }
+  return void 0;
+}
 var import_node_path5, FRONT_DOOR_PROTOCOL, FrontDoorSessionSchema, FrontDoorStateSchema, MAX_TCP_PORT, FrontDoorDirectRecordSchema, RECORD_TEMPORARY_FILE;
 var init_state = __esm({
   "src/frontdoor/state.ts"() {
     "use strict";
     import_node_path5 = __toESM(require("node:path"), 1);
     init_zod();
+    init_schema();
     FRONT_DOOR_PROTOCOL = 4;
-    FrontDoorSessionSchema = external_exports.strictObject({ pid: external_exports.number().int().positive(), startedAt: external_exports.number(), token: external_exports.string().min(1), supervisorPid: external_exports.number().int().positive().optional() });
+    FrontDoorSessionSchema = external_exports.strictObject({ pid: external_exports.number().int().positive(), startedAt: external_exports.number(), token: external_exports.string().min(1), supervisorPid: external_exports.number().int().positive().optional(), sessionId: external_exports.string().min(1).optional(), models: ModelsConfigSchema.optional() });
     FrontDoorStateSchema = external_exports.strictObject({
       /**
        * The launcher-to-door wire protocol this supervisor speaks, written once it is serving; absent in state written by a release that predates the field, which `ensureFrontDoor` reads as protocol 0. A launcher replaces a door whose protocol is lower than its own (see `FRONT_DOOR_PROTOCOL`).
@@ -32142,7 +32162,8 @@ function assembleCascade(input2) {
       ...config2.categories === void 0 ? {} : { categories: config2.categories },
       ...config2.entries === void 0 ? {} : { entries: config2.entries },
       ...entryOrder === void 0 ? {} : { entryOrder },
-      ...config2.launch === void 0 ? {} : { launch: config2.launch }
+      ...config2.launch === void 0 ? {} : { launch: config2.launch },
+      ...config2.models === void 0 ? {} : { models: config2.models }
     });
     nextId += 1;
   }
@@ -34676,7 +34697,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "claude-use",
-      version: "11.41.0",
+      version: "11.42.0",
       description: "A profile manager and launcher for Claude Code that lets one person run multiple logins from one machine while controlling what gets shared between them.",
       license: "MIT",
       author: "Joseph Mearman <joseph@mearman.co.uk>",
@@ -36251,6 +36272,219 @@ var init_realCredentialCache = __esm({
   }
 });
 
+// src/models/identity.ts
+function withoutContextMarker(model) {
+  return model.toLowerCase().endsWith(CONTEXT_MARKER_1M) ? model.slice(0, -CONTEXT_MARKER_1M.length) : model;
+}
+function canonicalText(name) {
+  return name.trim().toLowerCase().replace(NON_IDENTITY_BRACKET_RE, "").replace(/[\s_]+/g, "-").replace(/([a-z])(\d+(?:\.\d+)+)/g, "$1-$2").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+function splitVariants(tokens) {
+  const variants = [];
+  let end = tokens.length;
+  for (; ; ) {
+    const token = tokens[end - 1];
+    if (token === void 0 || !KNOWN_VARIANTS.has(token)) {
+      return { familyTokens: tokens.slice(0, end), variants };
+    }
+    variants.unshift(token);
+    end -= 1;
+  }
+}
+function versionOf(tokens) {
+  for (let index = 0; index < tokens.length; index += 1) {
+    const token = tokens[index];
+    const next = tokens[index + 1];
+    if (token === void 0) {
+      return "";
+    }
+    if (/^\d+$/.test(token) && next !== void 0 && /^\d+$/.test(next)) {
+      return `${token}.${next}`;
+    }
+    const dotted = /^\d+(?:\.\d+)+$/.exec(token);
+    if (dotted !== null) {
+      return dotted[0];
+    }
+  }
+  return "";
+}
+function modelIdentity(rawName) {
+  const segments = rawName.trim().toLowerCase().split("/");
+  const stripped = canonicalText(segments[segments.length - 1] ?? "").split(":")[0] ?? "";
+  const withoutDate = stripped.replace(DATE_STAMP_RE, "");
+  const tokens = withoutDate.split("-").filter((token) => token !== "");
+  const { familyTokens, variants } = splitVariants(tokens);
+  const version2 = versionOf(familyTokens);
+  const versionless = familyTokens.filter((token, index) => {
+    if (version2 === "") {
+      return true;
+    }
+    const dotted = /^\d+(?:\.\d+)+$/.test(token);
+    const previous = familyTokens[index - 1];
+    const next = familyTokens[index + 1];
+    const insideVersionRun = dotted || /^\d+$/.test(token) && (previous !== void 0 && /^\d+$/.test(previous) || next !== void 0 && /^\d+$/.test(next));
+    return !insideVersionRun;
+  });
+  const family = versionless.join("-");
+  const tokenVendor = familyTokens.find((token) => Object.keys(VENDOR_BY_TOKEN).some((key) => token === key || token.startsWith(key)));
+  const namespace = segments.length >= 2 ? (segments[0] ?? "").split(":").pop() ?? "" : "";
+  const namespaceVendor = VENDOR_BY_NAMESPACE[namespace] ?? "";
+  const tokenVendorName = tokenVendor === void 0 ? "" : VENDOR_BY_TOKEN[Object.keys(VENDOR_BY_TOKEN).find((key) => tokenVendor === key || tokenVendor.startsWith(key)) ?? ""] ?? "";
+  return {
+    vendor: tokenVendorName === "" ? namespaceVendor : tokenVendorName,
+    vendorConflict: tokenVendorName !== "" && namespaceVendor !== "" && tokenVendorName !== namespaceVendor,
+    family,
+    version: version2,
+    variant: variants.join("-"),
+    familyAndVersion: version2 === "" ? family : `${family}-${version2.replace(/\./g, "-")}`
+  };
+}
+function relateModels(left, right) {
+  const a10 = modelIdentity(left);
+  const b = modelIdentity(right);
+  if (a10.familyAndVersion !== b.familyAndVersion) {
+    return sameFamilyOtherVersion(a10, b) ? "similar" : "distinct";
+  }
+  if (a10.variant !== b.variant || a10.vendorConflict || b.vendorConflict || a10.vendor !== "" && b.vendor !== "" && a10.vendor !== b.vendor) {
+    return "similar";
+  }
+  return "same";
+}
+function sameFamilyOtherVersion(a10, b) {
+  if (a10.family !== b.family) {
+    return false;
+  }
+  if (a10.vendor !== "" && b.vendor !== "" && a10.vendor !== b.vendor) {
+    return false;
+  }
+  return true;
+}
+var NON_IDENTITY_BRACKET_RE, CONTEXT_MARKER_1M, DATE_STAMP_RE, KNOWN_VARIANTS, VENDOR_BY_NAMESPACE, VENDOR_BY_TOKEN;
+var init_identity2 = __esm({
+  "src/models/identity.ts"() {
+    "use strict";
+    NON_IDENTITY_BRACKET_RE = /\[[^\]]*\]/g;
+    CONTEXT_MARKER_1M = "[1m]";
+    DATE_STAMP_RE = /-(?:19|20)\d{2}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\d|3[01])$/;
+    KNOWN_VARIANTS = /* @__PURE__ */ new Set(["high", "medium", "low", "thinking", "xhigh", "max", "highspeed", "sol", "terra", "luna", "mini", "flash-lite", "turbo"]);
+    VENDOR_BY_NAMESPACE = Object.freeze({
+      anthropic: "anthropic",
+      google: "google",
+      openai: "openai",
+      zai: "zai",
+      "z-ai": "zai",
+      minimax: "minimax",
+      qwen: "qwen",
+      deepseek: "deepseek",
+      moonshot: "moonshot",
+      meta: "meta",
+      mistral: "mistral"
+    });
+    VENDOR_BY_TOKEN = Object.freeze({
+      claude: "anthropic",
+      gemini: "google",
+      antigravity: "google",
+      gpt: "openai",
+      glm: "zai",
+      minimax: "minimax",
+      qwen: "qwen",
+      deepseek: "deepseek",
+      kimi: "moonshot",
+      llama: "meta",
+      mistral: "mistral",
+      mixtral: "mistral"
+    });
+  }
+});
+
+// src/models/families.ts
+function modelOf(ref) {
+  const slash = ref.indexOf("/");
+  return slash === -1 ? ref : ref.slice(slash + 1);
+}
+function familyKeyOf(rawModel) {
+  const identity = modelIdentity(rawModel);
+  return identity.variant === "" ? identity.familyAndVersion : `${identity.familyAndVersion}${VARIANT_SEPARATOR}${identity.variant}`;
+}
+function assertionsOf(models) {
+  return { same: models?.same ?? [], distinct: models?.distinct ?? [] };
+}
+function sameModel(left, right, assertions) {
+  if (assertions.distinct.some(([a10, b]) => a10 === left && b === right || a10 === right && b === left)) {
+    return false;
+  }
+  const leftGroup = assertions.same.find((group) => group.includes(left));
+  const rightGroup = assertions.same.find((group) => group.includes(right));
+  if (leftGroup !== void 0 && leftGroup === rightGroup) {
+    return true;
+  }
+  if (leftGroup !== void 0 && !leftGroup.includes(right) || rightGroup !== void 0 && !rightGroup.includes(left)) {
+    return false;
+  }
+  return relateModels(modelOf(left), modelOf(right)) === "same";
+}
+function pinnedTo(settings2, ref) {
+  return settings2?.names?.some((name) => name === ref || name === modelOf(ref)) === true;
+}
+function buildFamilies(refs, models) {
+  const assertions = assertionsOf(models);
+  const settingsByKey = models?.families ?? {};
+  const groups = [];
+  for (const ref of refs) {
+    const pinnedKey = Object.entries(settingsByKey).find(([, settings2]) => pinnedTo(settings2, ref))?.[0];
+    const joined2 = groups.find((group) => pinnedKey === void 0 ? group.refs.some((first) => sameModel(first, ref, assertions)) : group.key === pinnedKey);
+    if (joined2 !== void 0) {
+      joined2.refs.push(ref);
+    } else {
+      groups.push({ key: pinnedKey ?? familyKeyOf(modelOf(ref)), refs: [ref] });
+    }
+  }
+  return groups.map((group) => ({ key: group.key, refs: group.refs, settings: settingsByKey[group.key] ?? {} }));
+}
+function familyNamed(families, member) {
+  if (!member.startsWith(FAMILY_PREFIX)) {
+    return void 0;
+  }
+  const key = member.slice(FAMILY_PREFIX.length);
+  return families.find((family) => family.key === key);
+}
+function familyCapabilities(settings2) {
+  return { vision: settings2.vision ?? true, tools: settings2.tools ?? true, thinking: settings2.thinking ?? true };
+}
+function familyMode(settings2) {
+  return settings2.mode ?? "ordered";
+}
+function sharedFamilies(families) {
+  return families.filter((family) => family.refs.length > 1);
+}
+function expandFamilyMembers(members2, families) {
+  const expanded = [];
+  for (const member of members2) {
+    for (const ref of member.startsWith(FAMILY_PREFIX) ? familyNamed(families, member)?.refs ?? [] : [member]) {
+      if (!expanded.includes(ref)) {
+        expanded.push(ref);
+      }
+    }
+  }
+  return expanded;
+}
+function familyOfRef(families, ref) {
+  return families.find((family) => family.refs.includes(ref));
+}
+function accountRefsOf(models) {
+  const named = [...(models?.same ?? []).flat(), ...Object.values(models?.families ?? {}).flatMap((settings2) => settings2.names ?? [])];
+  return [...new Set(named.filter((ref) => ref.startsWith("acct:")))];
+}
+var FAMILY_PREFIX, VARIANT_SEPARATOR;
+var init_families = __esm({
+  "src/models/families.ts"() {
+    "use strict";
+    init_identity2();
+    FAMILY_PREFIX = "family:";
+    VARIANT_SEPARATOR = "+";
+  }
+});
+
 // src/providersStore.ts
 function providerJsonPath(paths, name) {
   return import_node_path29.default.join(paths.providersDir, `${name}.json`);
@@ -36545,8 +36779,15 @@ function resolveRoutedProviderCredentials(params) {
   }
   const virtualNames = new Set(Object.keys(models.virtual ?? {}));
   const providerNames = /* @__PURE__ */ new Set();
+  const families = () => buildFamilies(params.targets?.() ?? [], models);
   const collect = (ref) => {
-    if (ref.startsWith("acct:") || ref.startsWith("family:") || virtualNames.has(ref)) {
+    if (ref.startsWith(FAMILY_PREFIX)) {
+      for (const target of expandFamilyMembers([ref], families())) {
+        collect(target);
+      }
+      return;
+    }
+    if (ref.startsWith("acct:") || virtualNames.has(ref)) {
       return;
     }
     const [provider] = ref.split("/", 1);
@@ -36603,6 +36844,7 @@ var init_providersStore = __esm({
     init_cliError();
     init_credential();
     init_walk();
+    init_families();
     ProviderNotFoundError = class extends CliError {
       constructor(name) {
         super(`No provider named "${name}". Run \`agent-shim provider add ${name}\` first.`);
@@ -62713,7 +62955,7 @@ function ensureFrontDoor(params) {
       if (state?.port !== void 0 && state.connectPort !== void 0) {
         if (supervisorPid === params.launcherPid && params.replace !== true && ports.isFrontDoorSupervisor(supervisorPid)) {
           const token = (0, import_node_crypto11.randomUUID)();
-          writeFrontDoorSession(ports.fs, paths.frontdoorSessionsDir, { pid: params.launcherPid, startedAt: ports.now(), token, supervisorPid });
+          writeFrontDoorSession(ports.fs, paths.frontdoorSessionsDir, { pid: params.launcherPid, startedAt: ports.now(), token, supervisorPid, ...recordOf(params.session) });
           return { port: state.port, connectPort: state.connectPort, token };
         }
         const verdict = verifyWithRetry(state.port);
@@ -62727,7 +62969,7 @@ function ensureFrontDoor(params) {
         }
         if (verdict.ok) {
           const token = (0, import_node_crypto11.randomUUID)();
-          writeFrontDoorSession(ports.fs, paths.frontdoorSessionsDir, { pid: params.launcherPid, startedAt: ports.now(), token, supervisorPid });
+          writeFrontDoorSession(ports.fs, paths.frontdoorSessionsDir, { pid: params.launcherPid, startedAt: ports.now(), token, supervisorPid, ...recordOf(params.session) });
           return { port: state.port, connectPort: state.connectPort, token };
         }
         lastRejection = `the listener on 127.0.0.1:${String(state.port)} (recorded for pid ${String(supervisorPid)}) failed authentication: ${verdict.reason}`;
@@ -62993,8 +63235,8 @@ function realRestartFrontDoor(paths, spawnDaemon) {
 }
 function realFrontDoorPort(paths, spawnDaemon) {
   return {
-    ensure: (inheritedExtraCaCerts) => {
-      const up2 = ensureFrontDoor({ paths, launcherPid: process.pid, ports: realEnsurePorts(paths, spawnDaemon) });
+    ensure: (inheritedExtraCaCerts, session) => {
+      const up2 = ensureFrontDoor({ paths, launcherPid: process.pid, ports: realEnsurePorts(paths, spawnDaemon), ...session === void 0 ? {} : { session } });
       const trust = resolveTrustBundle({ caCertFile: paths.frontdoorCaCertFile, bundlesDir: paths.frontdoorCaBundlesDir, variable: "NODE_EXTRA_CA_CERTS", inherited: inheritedExtraCaCerts, fs: realTrustBundleFs });
       return {
         port: up2.port,
@@ -63796,6 +64038,14 @@ function buildEnv(params) {
       env[key] = value2;
     }
   }
+  if (params.routeByName) {
+    for (const tier of CLAUDE_TIERS) {
+      const ref = params.tierModels?.[tier];
+      if (ref !== void 0) {
+        env[`ANTHROPIC_DEFAULT_${tier.toUpperCase()}_MODEL`] = ref;
+      }
+    }
+  }
   if (params.provider !== void 0) {
     env.ANTHROPIC_AUTH_TOKEN = params.remoteControl ? void 0 : PROVIDER_SESSION_PLACEHOLDER;
     env.ANTHROPIC_API_KEY = void 0;
@@ -63838,6 +64088,7 @@ var init_flags = __esm({
     init_envBool();
     init_cliError();
     init_conditions();
+    init_schema();
     init_credential();
     init_headers();
     init_capability();
@@ -64216,131 +64467,6 @@ var init_launchReport = __esm({
   }
 });
 
-// src/models/identity.ts
-function withoutContextMarker(model) {
-  return model.toLowerCase().endsWith(CONTEXT_MARKER_1M) ? model.slice(0, -CONTEXT_MARKER_1M.length) : model;
-}
-function canonicalText(name) {
-  return name.trim().toLowerCase().replace(NON_IDENTITY_BRACKET_RE, "").replace(/[\s_]+/g, "-").replace(/([a-z])(\d+(?:\.\d+)+)/g, "$1-$2").replace(/-+/g, "-").replace(/^-|-$/g, "");
-}
-function splitVariants(tokens) {
-  const variants = [];
-  let end = tokens.length;
-  for (; ; ) {
-    const token = tokens[end - 1];
-    if (token === void 0 || !KNOWN_VARIANTS.has(token)) {
-      return { familyTokens: tokens.slice(0, end), variants };
-    }
-    variants.unshift(token);
-    end -= 1;
-  }
-}
-function versionOf(tokens) {
-  for (let index = 0; index < tokens.length; index += 1) {
-    const token = tokens[index];
-    const next = tokens[index + 1];
-    if (token === void 0) {
-      return "";
-    }
-    if (/^\d+$/.test(token) && next !== void 0 && /^\d+$/.test(next)) {
-      return `${token}.${next}`;
-    }
-    const dotted = /^\d+(?:\.\d+)+$/.exec(token);
-    if (dotted !== null) {
-      return dotted[0];
-    }
-  }
-  return "";
-}
-function modelIdentity(rawName) {
-  const segments = rawName.trim().toLowerCase().split("/");
-  const stripped = canonicalText(segments[segments.length - 1] ?? "").split(":")[0] ?? "";
-  const withoutDate = stripped.replace(DATE_STAMP_RE, "");
-  const tokens = withoutDate.split("-").filter((token) => token !== "");
-  const { familyTokens, variants } = splitVariants(tokens);
-  const version2 = versionOf(familyTokens);
-  const versionless = familyTokens.filter((token, index) => {
-    if (version2 === "") {
-      return true;
-    }
-    const dotted = /^\d+(?:\.\d+)+$/.test(token);
-    const previous = familyTokens[index - 1];
-    const next = familyTokens[index + 1];
-    const insideVersionRun = dotted || /^\d+$/.test(token) && (previous !== void 0 && /^\d+$/.test(previous) || next !== void 0 && /^\d+$/.test(next));
-    return !insideVersionRun;
-  });
-  const family = versionless.join("-");
-  const tokenVendor = familyTokens.find((token) => Object.keys(VENDOR_BY_TOKEN).some((key) => token === key || token.startsWith(key)));
-  const namespace = segments.length >= 2 ? (segments[0] ?? "").split(":").pop() ?? "" : "";
-  const namespaceVendor = VENDOR_BY_NAMESPACE[namespace] ?? "";
-  const tokenVendorName = tokenVendor === void 0 ? "" : VENDOR_BY_TOKEN[Object.keys(VENDOR_BY_TOKEN).find((key) => tokenVendor === key || tokenVendor.startsWith(key)) ?? ""] ?? "";
-  return {
-    vendor: tokenVendorName === "" ? namespaceVendor : tokenVendorName,
-    vendorConflict: tokenVendorName !== "" && namespaceVendor !== "" && tokenVendorName !== namespaceVendor,
-    family,
-    version: version2,
-    variant: variants.join("-"),
-    familyAndVersion: version2 === "" ? family : `${family}-${version2.replace(/\./g, "-")}`
-  };
-}
-function relateModels(left, right) {
-  const a10 = modelIdentity(left);
-  const b = modelIdentity(right);
-  if (a10.familyAndVersion !== b.familyAndVersion) {
-    return sameFamilyOtherVersion(a10, b) ? "similar" : "distinct";
-  }
-  if (a10.variant !== b.variant || a10.vendorConflict || b.vendorConflict || a10.vendor !== "" && b.vendor !== "" && a10.vendor !== b.vendor) {
-    return "similar";
-  }
-  return "same";
-}
-function sameFamilyOtherVersion(a10, b) {
-  if (a10.family !== b.family) {
-    return false;
-  }
-  if (a10.vendor !== "" && b.vendor !== "" && a10.vendor !== b.vendor) {
-    return false;
-  }
-  return true;
-}
-var NON_IDENTITY_BRACKET_RE, CONTEXT_MARKER_1M, DATE_STAMP_RE, KNOWN_VARIANTS, VENDOR_BY_NAMESPACE, VENDOR_BY_TOKEN;
-var init_identity2 = __esm({
-  "src/models/identity.ts"() {
-    "use strict";
-    NON_IDENTITY_BRACKET_RE = /\[[^\]]*\]/g;
-    CONTEXT_MARKER_1M = "[1m]";
-    DATE_STAMP_RE = /-(?:19|20)\d{2}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\d|3[01])$/;
-    KNOWN_VARIANTS = /* @__PURE__ */ new Set(["high", "medium", "low", "thinking", "xhigh", "max", "highspeed", "sol", "terra", "luna", "mini", "flash-lite", "turbo"]);
-    VENDOR_BY_NAMESPACE = Object.freeze({
-      anthropic: "anthropic",
-      google: "google",
-      openai: "openai",
-      zai: "zai",
-      "z-ai": "zai",
-      minimax: "minimax",
-      qwen: "qwen",
-      deepseek: "deepseek",
-      moonshot: "moonshot",
-      meta: "meta",
-      mistral: "mistral"
-    });
-    VENDOR_BY_TOKEN = Object.freeze({
-      claude: "anthropic",
-      gemini: "google",
-      antigravity: "google",
-      gpt: "openai",
-      glm: "zai",
-      minimax: "minimax",
-      qwen: "qwen",
-      deepseek: "deepseek",
-      kimi: "moonshot",
-      llama: "meta",
-      mistral: "mistral",
-      mixtral: "mistral"
-    });
-  }
-});
-
 // src/selection/engine.ts
 function compareMaybe(left, right, preferHigh) {
   if (left === void 0 && right === void 0) {
@@ -65483,7 +65609,7 @@ function catalogueUrls(provider, catalogue) {
 function isRecord9(value2) {
   return typeof value2 === "object" && value2 !== null && !Array.isArray(value2);
 }
-function modelOf(entry) {
+function modelOf2(entry) {
   if (typeof entry === "string") {
     return entry.trim() === "" ? void 0 : { id: entry.trim() };
   }
@@ -65499,7 +65625,7 @@ function parseCatalogueBody(body) {
   const seen = /* @__PURE__ */ new Set();
   const models = [];
   for (const entry of list) {
-    const model = modelOf(entry);
+    const model = modelOf2(entry);
     if (model !== void 0 && !seen.has(model.id)) {
       seen.add(model.id);
       models.push(model);
@@ -65564,147 +65690,6 @@ var init_providerCatalogue = __esm({
   }
 });
 
-// src/launcher/modelPicker.ts
-function labelOf(model) {
-  return withoutContextMarker(model);
-}
-function describedAs(model, description) {
-  return model.toLowerCase().endsWith(CONTEXT_MARKER_1M) ? `${description}; 1M context` : description;
-}
-function joined(parts) {
-  const last = parts[parts.length - 1];
-  return last === void 0 || parts.length === 1 ? last ?? "" : `${parts.slice(0, -1).join(", ")} and ${last}`;
-}
-function rowOf(model, reaches) {
-  const lead = reaches.find((reach) => reach.standing === "first") ?? reaches[0];
-  if (lead === void 0) {
-    throw new Error(`model ${model} is reached by no tier`);
-  }
-  const firsts = reaches.filter((reach) => reach.standing === "first").map((reach) => reach.tier);
-  const fallbacks = reaches.filter((reach) => reach.standing === "fallback").map((reach) => reach.tier);
-  const serves = firsts.length === 0 ? [] : [`Serves the ${joined(firsts)} tier${firsts.length === 1 ? "" : "s"}`];
-  const falls = fallbacks.length === 0 ? [] : [`${serves.length === 0 ? "Fallback" : "fallback"} for ${joined(fallbacks)}`];
-  return { model, label: labelOf(model), description: describedAs(model, [...serves, ...falls].join("; ")), behavesAs: TIER_BEHAVES_AS[lead.tier] };
-}
-function rowsOfTable(table) {
-  const reachesByModel = /* @__PURE__ */ new Map();
-  for (const [tier, candidates] of table) {
-    candidates.forEach((model, index) => {
-      const reaches = reachesByModel.get(model) ?? [];
-      if (!reaches.some((reach) => reach.tier === tier)) {
-        reaches.push({ tier, standing: index === 0 ? "first" : "fallback" });
-      }
-      reachesByModel.set(model, reaches);
-    });
-  }
-  return [...reachesByModel].map(([model, reaches]) => rowOf(model, reaches));
-}
-function antigravityRows(provider) {
-  const config2 = resolveAntigravityConfig(provider.antigravity);
-  const tiers = rowsOfTable(CLAUDE_TIERS.map((tier) => [tier, config2.models[tier]]));
-  const behavesAsOf = new Map(tiers.map((row) => [row.model, row.behavesAs]));
-  const aliases = [...config2.aliases].flatMap(([alias, candidates]) => {
-    const [first] = candidates;
-    const behavesAs = first === void 0 ? void 0 : behavesAsOf.get(first);
-    const description = alias === AUTO_ALIAS ? `Routes each request to a backend model with quota left, best first (${String(candidates.length)} models)` : `Alias for ${candidates.join(", then ")}`;
-    return behavesAs === void 0 ? [] : [{ model: alias, label: labelOf(alias), description, behavesAs }];
-  });
-  return [...aliases.filter((row) => row.model === AUTO_ALIAS), ...tiers, ...aliases.filter((row) => row.model !== AUTO_ALIAS)];
-}
-function codexRows(provider) {
-  const config2 = resolveCodexConfig(provider.codex);
-  return rowsOfTable(CLAUDE_TIERS.map((tier) => [tier, [config2.models[tier]]]));
-}
-function httpRows(provider) {
-  const env = provider.env ?? {};
-  const table = CLAUDE_TIERS.flatMap((tier) => {
-    const model = env[TIER_ENV_VARIABLES[tier]];
-    return model === void 0 || model === "" ? [] : [[tier, [model]]];
-  });
-  return rowsOfTable(table);
-}
-function declaredRow(entry) {
-  return {
-    model: entry.model,
-    label: entry.label ?? labelOf(entry.model),
-    description: entry.description ?? describedAs(entry.model, `Declared by the provider for the ${entry.tier} tier`),
-    behavesAs: TIER_BEHAVES_AS[entry.tier]
-  };
-}
-function catalogueRows(provider, models) {
-  if (provider.kind !== void 0 && provider.kind !== "http" || provider.catalogue === void 0) {
-    return [];
-  }
-  const { tier } = provider.catalogue;
-  return filterCatalogue(models, provider.catalogue).map((model) => ({ model: model.id, label: labelOf(model.id), description: describedAs(model.id, model.name === void 0 ? "Listed by the provider" : `Listed by the provider as ${model.name}`), behavesAs: TIER_BEHAVES_AS[tier] })).sort((left, right) => left.model.localeCompare(right.model));
-}
-function providerModelRows(provider, catalogue = []) {
-  const derived2 = provider.kind === "codex" ? codexRows(provider) : provider.kind === "antigravity" ? antigravityRows(provider) : provider.kind === "router" ? [] : httpRows(provider);
-  const declared = provider.kind === "router" ? [] : (provider.pickerModels ?? []).map(declaredRow);
-  const declaredModels = new Set(declared.map((row) => row.model));
-  const named = [...derived2.filter((row) => !declaredModels.has(row.model)), ...declared];
-  const taken = new Set(named.map((row) => labelOf(row.model)));
-  return [...named, ...catalogueRows(provider, catalogue).filter((row) => !taken.has(labelOf(row.model)))];
-}
-function routedModelRows(models, providers) {
-  const hidden = new Set(models.hide ?? []);
-  const shown = models.show === void 0 ? void 0 : new Set(models.show);
-  const visible = (model) => shown === void 0 ? !hidden.has(model) : shown.has(model);
-  const tierOf = (model) => {
-    for (const [, provider] of providers) {
-      if (provider.kind !== void 0 && provider.kind !== "http") {
-        continue;
-      }
-      const match = Object.entries(provider.env ?? {}).find(([key, value2]) => value2 === model && key.startsWith("ANTHROPIC_DEFAULT_") && key.endsWith("_MODEL"));
-      if (match !== void 0) {
-        const tier = match[0].replace("ANTHROPIC_DEFAULT_", "").replace("_MODEL", "").toLowerCase();
-        return tier === "fable" || tier === "opus" || tier === "sonnet" || tier === "haiku" ? tier : void 0;
-      }
-    }
-    return void 0;
-  };
-  const virtual = Object.entries(models.virtual ?? {}).flatMap(([name, definition]) => {
-    if (!visible(name)) {
-      return [];
-    }
-    const first = definition.members.find((member) => member.includes("/"));
-    const tier = first === void 0 ? void 0 : tierOf(first.split("/").slice(1).join("/"));
-    const behavesAs = tier === void 0 ? void 0 : TIER_BEHAVES_AS[tier];
-    return behavesAs === void 0 ? [] : [{ model: name, label: name, description: `Virtual (${definition.mode})`, behavesAs }];
-  });
-  const concrete = providers.flatMap(([name, provider]) => providerModelRows(provider).map((row) => ({ ...row, model: `${name}/${row.model}`, label: `${name} / ${row.label}`, description: `${name}: ${row.description}` })));
-  return [...virtual, ...concrete.filter((row) => visible(row.model))];
-}
-function modelPickerSettings(provider, catalogue = []) {
-  return modelPickerSettingsFromRows(providerModelRows(provider, catalogue), true);
-}
-function modelPickerSettingsFromRows(options, replaceBuiltInOptions) {
-  return options.length === 0 ? void 0 : JSON.stringify({ modelPicker: { options, replaceBuiltInOptions } });
-}
-var TIER_BEHAVES_AS, TIER_ENV_VARIABLES;
-var init_modelPicker = __esm({
-  "src/launcher/modelPicker.ts"() {
-    "use strict";
-    init_translate();
-    init_translate2();
-    init_providerCatalogue();
-    init_schema();
-    init_identity2();
-    TIER_BEHAVES_AS = Object.freeze({
-      fable: "claude-fable-5-1",
-      opus: "claude-opus-5-5",
-      sonnet: "claude-sonnet-5-5",
-      haiku: "claude-haiku-5-5"
-    });
-    TIER_ENV_VARIABLES = Object.freeze({
-      fable: "ANTHROPIC_DEFAULT_FABLE_MODEL",
-      opus: "ANTHROPIC_DEFAULT_OPUS_MODEL",
-      sonnet: "ANTHROPIC_DEFAULT_SONNET_MODEL",
-      haiku: "ANTHROPIC_DEFAULT_HAIKU_MODEL"
-    });
-  }
-});
-
 // src/modelsStore.ts
 function readModels(paths) {
   return readGlobalConfig(paths)?.models;
@@ -65855,6 +65840,148 @@ var init_modelsStore = __esm({
   }
 });
 
+// src/launcher/modelPicker.ts
+function labelOf(model) {
+  return withoutContextMarker(model);
+}
+function describedAs(model, description) {
+  return model.toLowerCase().endsWith(CONTEXT_MARKER_1M) ? `${description}; 1M context` : description;
+}
+function joined(parts) {
+  const last = parts[parts.length - 1];
+  return last === void 0 || parts.length === 1 ? last ?? "" : `${parts.slice(0, -1).join(", ")} and ${last}`;
+}
+function rowOf(model, reaches) {
+  const lead = reaches.find((reach) => reach.standing === "first") ?? reaches[0];
+  if (lead === void 0) {
+    throw new Error(`model ${model} is reached by no tier`);
+  }
+  const firsts = reaches.filter((reach) => reach.standing === "first").map((reach) => reach.tier);
+  const fallbacks = reaches.filter((reach) => reach.standing === "fallback").map((reach) => reach.tier);
+  const serves = firsts.length === 0 ? [] : [`Serves the ${joined(firsts)} tier${firsts.length === 1 ? "" : "s"}`];
+  const falls = fallbacks.length === 0 ? [] : [`${serves.length === 0 ? "Fallback" : "fallback"} for ${joined(fallbacks)}`];
+  return { model, label: labelOf(model), description: describedAs(model, [...serves, ...falls].join("; ")), behavesAs: TIER_BEHAVES_AS[lead.tier] };
+}
+function rowsOfTable(table) {
+  const reachesByModel = /* @__PURE__ */ new Map();
+  for (const [tier, candidates] of table) {
+    candidates.forEach((model, index) => {
+      const reaches = reachesByModel.get(model) ?? [];
+      if (!reaches.some((reach) => reach.tier === tier)) {
+        reaches.push({ tier, standing: index === 0 ? "first" : "fallback" });
+      }
+      reachesByModel.set(model, reaches);
+    });
+  }
+  return [...reachesByModel].map(([model, reaches]) => rowOf(model, reaches));
+}
+function antigravityRows(provider) {
+  const config2 = resolveAntigravityConfig(provider.antigravity);
+  const tiers = rowsOfTable(CLAUDE_TIERS.map((tier) => [tier, config2.models[tier]]));
+  const behavesAsOf = new Map(tiers.map((row) => [row.model, row.behavesAs]));
+  const aliases = [...config2.aliases].flatMap(([alias, candidates]) => {
+    const [first] = candidates;
+    const behavesAs = first === void 0 ? void 0 : behavesAsOf.get(first);
+    const description = alias === AUTO_ALIAS ? `Routes each request to a backend model with quota left, best first (${String(candidates.length)} models)` : `Alias for ${candidates.join(", then ")}`;
+    return behavesAs === void 0 ? [] : [{ model: alias, label: labelOf(alias), description, behavesAs }];
+  });
+  return [...aliases.filter((row) => row.model === AUTO_ALIAS), ...tiers, ...aliases.filter((row) => row.model !== AUTO_ALIAS)];
+}
+function codexRows(provider) {
+  const config2 = resolveCodexConfig(provider.codex);
+  return rowsOfTable(CLAUDE_TIERS.map((tier) => [tier, [config2.models[tier]]]));
+}
+function httpRows(provider) {
+  const env = provider.env ?? {};
+  const table = CLAUDE_TIERS.flatMap((tier) => {
+    const model = env[TIER_ENV_VARIABLES[tier]];
+    return model === void 0 || model === "" ? [] : [[tier, [model]]];
+  });
+  return rowsOfTable(table);
+}
+function declaredRow(entry) {
+  return {
+    model: entry.model,
+    label: entry.label ?? labelOf(entry.model),
+    description: entry.description ?? describedAs(entry.model, `Declared by the provider for the ${entry.tier} tier`),
+    behavesAs: TIER_BEHAVES_AS[entry.tier]
+  };
+}
+function catalogueRows(provider, models) {
+  if (provider.kind !== void 0 && provider.kind !== "http" || provider.catalogue === void 0) {
+    return [];
+  }
+  const { tier } = provider.catalogue;
+  return filterCatalogue(models, provider.catalogue).map((model) => ({ model: model.id, label: labelOf(model.id), description: describedAs(model.id, model.name === void 0 ? "Listed by the provider" : `Listed by the provider as ${model.name}`), behavesAs: TIER_BEHAVES_AS[tier] })).sort((left, right) => left.model.localeCompare(right.model));
+}
+function providerModelRows(provider, catalogue = []) {
+  const derived2 = provider.kind === "codex" ? codexRows(provider) : provider.kind === "antigravity" ? antigravityRows(provider) : provider.kind === "router" ? [] : httpRows(provider);
+  const declared = provider.kind === "router" ? [] : (provider.pickerModels ?? []).map(declaredRow);
+  const declaredModels = new Set(declared.map((row) => row.model));
+  const named = [...derived2.filter((row) => !declaredModels.has(row.model)), ...declared];
+  const taken = new Set(named.map((row) => labelOf(row.model)));
+  return [...named, ...catalogueRows(provider, catalogue).filter((row) => !taken.has(labelOf(row.model)))];
+}
+function routedModelRows(models, providers) {
+  const hidden = new Set(models.hide ?? []);
+  const shown = models.show === void 0 ? void 0 : new Set(models.show);
+  const visible = (model) => shown === void 0 ? !hidden.has(model) : shown.has(model);
+  const concrete = providers.flatMap(([name, provider]) => providerModelRows(provider).map((row) => ({ ...row, model: `${name}/${row.model}`, label: `${name} / ${row.label}`, description: `${name}: ${row.description}` })));
+  const concreteByRef = new Map(concrete.map((row) => [row.model, row]));
+  const families = buildFamilies([...concrete.map((row) => row.model), ...accountRefsOf(models)], models);
+  const handlingOf = (refs) => refs.map((ref) => concreteByRef.get(ref)?.behavesAs).find((behavesAs) => behavesAs !== void 0) ?? TIER_BEHAVES_AS.sonnet;
+  const virtual = Object.entries(models.virtual ?? {}).flatMap(([name, definition]) => {
+    if (!visible(name)) {
+      return [];
+    }
+    const targets = expandFamilyMembers(safeExpand(name, models), families);
+    return [{ model: name, label: name, description: `Virtual (${definition.mode})`, behavesAs: handlingOf(targets) }];
+  });
+  const familyRows = sharedFamilies(families).flatMap((family) => {
+    const member = `${FAMILY_PREFIX}${family.key}`;
+    return visible(member) ? [{ model: member, label: family.key, description: `Family (${familyMode(family.settings)}): ${family.refs.join(", ")}`, behavesAs: handlingOf(family.refs) }] : [];
+  });
+  return [...virtual, ...familyRows, ...concrete.filter((row) => visible(row.model))];
+}
+function safeExpand(name, models) {
+  try {
+    return expandMembers(name, models);
+  } catch {
+    return models.virtual?.[name]?.members ?? [];
+  }
+}
+function modelPickerSettings(provider, catalogue = []) {
+  return modelPickerSettingsFromRows(providerModelRows(provider, catalogue), true);
+}
+function modelPickerSettingsFromRows(options, replaceBuiltInOptions) {
+  return options.length === 0 ? void 0 : JSON.stringify({ modelPicker: { options, replaceBuiltInOptions } });
+}
+var TIER_BEHAVES_AS, TIER_ENV_VARIABLES;
+var init_modelPicker = __esm({
+  "src/launcher/modelPicker.ts"() {
+    "use strict";
+    init_translate();
+    init_translate2();
+    init_providerCatalogue();
+    init_schema();
+    init_identity2();
+    init_families();
+    init_modelsStore();
+    TIER_BEHAVES_AS = Object.freeze({
+      fable: "claude-fable-5-1",
+      opus: "claude-opus-5-5",
+      sonnet: "claude-sonnet-5-5",
+      haiku: "claude-haiku-5-5"
+    });
+    TIER_ENV_VARIABLES = Object.freeze({
+      fable: "ANTHROPIC_DEFAULT_FABLE_MODEL",
+      opus: "ANTHROPIC_DEFAULT_OPUS_MODEL",
+      sonnet: "ANTHROPIC_DEFAULT_SONNET_MODEL",
+      haiku: "ANTHROPIC_DEFAULT_HAIKU_MODEL"
+    });
+  }
+});
+
 // src/launcher/pool.ts
 function isResuming(passthrough) {
   const end = passthrough.indexOf(TERMINATOR3);
@@ -66054,6 +66181,26 @@ var init_launchHook = __esm({
   }
 });
 
+// src/models/targets.ts
+function providerModels(paths) {
+  return listProviders(paths).flatMap((entry) => {
+    const catalogue = parseCatalogueCache(realFsPort.readFileUtf8(catalogueCachePath(paths, entry.name)));
+    return providerModelRows(entry.provider, catalogue?.models).map((row) => ({ provider: entry.name, model: row.model }));
+  });
+}
+function targetRefs(paths) {
+  return providerModels(paths).map((entry) => `${entry.provider}/${entry.model}`);
+}
+var init_targets = __esm({
+  "src/models/targets.ts"() {
+    "use strict";
+    init_modelPicker();
+    init_providerCatalogue();
+    init_providersStore();
+    init_realPorts();
+  }
+});
+
 // src/launcher.ts
 function resolveIdentityCredential(identity, credential, env, port) {
   if (port === void 0) {
@@ -66245,10 +66392,12 @@ function decideLaunch(params, readOnly) {
   }
   const launchCascade = farmContext?.cascade ?? (params.farm === void 0 ? void 0 : params.farm.loadCascade(configProfileDecision.name, cliOverride));
   let cascadeLaunch;
+  let cascadeModels;
   if (launchCascade !== void 0 && params.farm !== void 0) {
     const assembled = assembleCascade(launchCascade);
     const flattened = flattenLayers(assembled.layers, { home: params.farm.home });
     cascadeLaunch = flattened.launch;
+    cascadeModels = flattened.models;
     if (readOnly || farmContext === void 0) {
       reportDiagnostics(log, [...assembled.diagnostics, ...flattened.diagnostics], { errorsAsWarnings: readOnly });
     }
@@ -66277,7 +66426,9 @@ function decideLaunch(params, readOnly) {
   const flags = loginlessProvider === void 0 ? requestedFlags : { ...requestedFlags, remoteControl: false };
   const catalogue = selectedProvider === void 0 ? void 0 : parseCatalogueCache(params.fs.readFileUtf8(catalogueCachePath(paths, selectedProvider.name)));
   const routesByName = flags.routeByName || selectedProvider !== void 0 && isRouterProvider(selectedProvider.definition);
-  const pickerSettings = routesByName ? modelPickerSettingsFromRows(routedModelRows(readModels(paths) ?? {}, listProviders(paths).map((entry) => [entry.name, entry.provider])), selectedProvider !== void 0) : selectedProvider === void 0 ? void 0 : modelPickerSettings(selectedProvider.definition, catalogue?.models);
+  const globalModels = loadConfigFile(paths.globalConfigFile, GlobalConfigSchema, params.fs.readConfigFile)?.config.models;
+  const models = launchCascade !== void 0 && params.farm !== void 0 ? cascadeModels : globalModels;
+  const pickerSettings = routesByName ? modelPickerSettingsFromRows(routedModelRows(models ?? {}, listProviders(paths).map((entry) => [entry.name, entry.provider])), selectedProvider !== void 0) : selectedProvider === void 0 ? void 0 : modelPickerSettings(selectedProvider.definition, catalogue?.models);
   const callerSettings = hasSettingsArgument(parsedArgv.rest);
   if (pickerSettings !== void 0 && callerSettings) {
     notes.push("--settings was passed, so /model keeps Claude Code's own model names");
@@ -66315,6 +66466,8 @@ function decideLaunch(params, readOnly) {
     identityCredential,
     pinnedVersion,
     flags,
+    models,
+    globalModels,
     bin: discovered.path,
     args,
     decision
@@ -66381,7 +66534,7 @@ function prepareLaunch(params) {
   }
   const routesByName = resolvedFlags.routeByName || resolvedProvider !== void 0 && isRouterProvider(resolvedProvider.definition);
   if (routesByName) {
-    const check2 = resolveRoutedProviderCredentials({ paths, port: params.fs, env, ...params.credentials === void 0 ? {} : { credentials: params.credentials }, models: loadConfigFile(paths.globalConfigFile, GlobalConfigSchema, params.fs.readConfigFile)?.config.models });
+    const check2 = resolveRoutedProviderCredentials({ paths, port: params.fs, env, ...params.credentials === void 0 ? {} : { credentials: params.credentials }, models: decided.models, targets: () => targetRefs(paths) });
     if (!check2.ok) {
       log.error(check2.message);
       proc.exit(check2.status);
@@ -66393,7 +66546,10 @@ function prepareLaunch(params) {
     log.error("agent-shim: this launch routes through the front-door daemon, but this launcher has no front-door port wired; refusing to launch without it.");
     proc.exit(1);
   }
-  const frontDoor = frontDoorEngaged && frontDoorPort !== void 0 ? frontDoorPort.ensure(env.NODE_EXTRA_CA_CERTS) : void 0;
+  const sessionId = params.supervised?.sessionId ?? (0, import_node_crypto18.randomUUID)();
+  const resolvedModels = decided.models ?? (decided.globalModels === void 0 ? void 0 : {});
+  const sessionModels = (0, import_node_util6.isDeepStrictEqual)(resolvedModels, decided.globalModels) ? void 0 : resolvedModels;
+  const frontDoor = frontDoorEngaged && frontDoorPort !== void 0 ? frontDoorPort.ensure(env.NODE_EXTRA_CA_CERTS, { sessionId, ...sessionModels === void 0 ? {} : { models: sessionModels } }) : void 0;
   if (frontDoor?.trustWarning !== void 0) {
     log.warn(frontDoor.trustWarning);
   }
@@ -66407,7 +66563,6 @@ function prepareLaunch(params) {
   }
   rows.push(...routingRows({ frontDoor, headroom, provider: resolvedProvider !== void 0 }));
   const frontDoorRelease = frontDoor === void 0 ? void 0 : frontDoorPort?.release;
-  const sessionId = params.supervised?.sessionId ?? (0, import_node_crypto18.randomUUID)();
   const finalEnv = buildEnv({
     baseEnv: env,
     configDirEscapeHatch: configDirEscapeHatchApplies,
@@ -66419,7 +66574,8 @@ function prepareLaunch(params) {
     ...headroom === void 0 ? {} : { headroom },
     sessionId,
     remoteControl: resolvedFlags.remoteControl,
-    routeByName: routesByName
+    routeByName: routesByName,
+    ...decided.models?.tiers === void 0 ? {} : { tierModels: decided.models.tiers }
   });
   const releases = [...headroom === void 0 || headroomPort === void 0 ? [] : [headroomPort.release], ...frontDoorRelease === void 0 ? [] : [frontDoorRelease]];
   const release = () => {
@@ -66481,11 +66637,12 @@ function runLaunchPlan(plan, spawn8) {
 function runLauncher(params) {
   params.proc.exit(runLaunchPlan(prepareLaunch(params), params.spawn));
 }
-var import_node_crypto18, import_node_path44;
+var import_node_crypto18, import_node_util6, import_node_path44;
 var init_launcher = __esm({
   "src/launcher.ts"() {
     "use strict";
     import_node_crypto18 = require("node:crypto");
+    import_node_util6 = require("node:util");
     import_node_path44 = __toESM(require("node:path"), 1);
     init_package();
     init_envBool();
@@ -66502,7 +66659,6 @@ var init_launcher = __esm({
     init_launchReport();
     init_modelPicker();
     init_providerCatalogue();
-    init_modelsStore();
     init_providersStore();
     init_pool();
     init_resumeContext();
@@ -66520,6 +66676,7 @@ var init_launcher = __esm({
     init_read();
     init_claudeVersion();
     init_launchHook();
+    init_targets();
   }
 });
 
@@ -119819,56 +119976,7 @@ init_source();
 
 // src/models/doctor.ts
 init_modelsStore();
-
-// src/models/families.ts
-init_identity2();
-var FAMILY_PREFIX = "family:";
-var VARIANT_SEPARATOR = "+";
-function modelOf2(ref) {
-  const slash = ref.indexOf("/");
-  return slash === -1 ? ref : ref.slice(slash + 1);
-}
-function familyKeyOf(rawModel) {
-  const identity = modelIdentity(rawModel);
-  return identity.variant === "" ? identity.familyAndVersion : `${identity.familyAndVersion}${VARIANT_SEPARATOR}${identity.variant}`;
-}
-function assertionsOf(models) {
-  return { same: models?.same ?? [], distinct: models?.distinct ?? [] };
-}
-function sameModel(left, right, assertions) {
-  if (assertions.distinct.some(([a10, b]) => a10 === left && b === right || a10 === right && b === left)) {
-    return false;
-  }
-  const leftGroup = assertions.same.find((group) => group.includes(left));
-  const rightGroup = assertions.same.find((group) => group.includes(right));
-  if (leftGroup !== void 0 && leftGroup === rightGroup) {
-    return true;
-  }
-  if (leftGroup !== void 0 && !leftGroup.includes(right) || rightGroup !== void 0 && !rightGroup.includes(left)) {
-    return false;
-  }
-  return relateModels(modelOf2(left), modelOf2(right)) === "same";
-}
-function pinnedTo(settings2, ref) {
-  return settings2?.names?.some((name) => name === ref || name === modelOf2(ref)) === true;
-}
-function buildFamilies(refs, models) {
-  const assertions = assertionsOf(models);
-  const settingsByKey = models?.families ?? {};
-  const groups = [];
-  for (const ref of refs) {
-    const pinnedKey = Object.entries(settingsByKey).find(([, settings2]) => pinnedTo(settings2, ref))?.[0];
-    const joined2 = groups.find((group) => pinnedKey === void 0 ? group.refs.some((first) => sameModel(first, ref, assertions)) : group.key === pinnedKey);
-    if (joined2 !== void 0) {
-      joined2.refs.push(ref);
-    } else {
-      groups.push({ key: pinnedKey ?? familyKeyOf(modelOf2(ref)), refs: [ref] });
-    }
-  }
-  return groups.map((group) => ({ key: group.key, refs: group.refs, settings: settingsByKey[group.key] ?? {} }));
-}
-
-// src/models/doctor.ts
+init_families();
 init_identity2();
 function modelsFindings(input2) {
   const findings = [];
@@ -119956,22 +120064,8 @@ function modelsFindings(input2) {
   return findings;
 }
 
-// src/models/targets.ts
-init_modelPicker();
-init_providerCatalogue();
-init_providersStore();
-init_realPorts();
-function providerModels(paths) {
-  return listProviders(paths).flatMap((entry) => {
-    const catalogue = parseCatalogueCache(realFsPort.readFileUtf8(catalogueCachePath(paths, entry.name)));
-    return providerModelRows(entry.provider, catalogue?.models).map((row) => ({ provider: entry.name, model: row.model }));
-  });
-}
-function targetRefs(paths) {
-  return providerModels(paths).map((entry) => `${entry.provider}/${entry.model}`);
-}
-
 // src/doctorReport.ts
+init_targets();
 init_configProfilesStore();
 
 // src/headroom/allowlistDrift.ts
@@ -131728,6 +131822,7 @@ function candidateOf(ref, order, facts, isCurrent) {
 
 // src/frontdoor/providerRoute.ts
 init_engine();
+init_families();
 init_identity2();
 init_route();
 var import_node_stream3 = require("node:stream");
@@ -131818,37 +131913,45 @@ function scopeSessionProviderPath(request7) {
   }
   return { ...request7, url: `${PROVIDER_PATH_PREFIX}${encodeURIComponent(request7.session.provider)}${request7.url}` };
 }
-function resolveRoutedModel(model, providerName, session, includeUnqualified, deps, memory, rotations) {
-  const models = deps.models?.();
+var CHARS_PER_TOKEN2 = 4;
+function needsOf(scan) {
+  return { hasImage: scan.hasImage === true, hasTools: scan.toolsPresent === true, thinking: scan.thinking === true, contextTokens: Math.ceil((scan.text?.length ?? 0) / CHARS_PER_TOKEN2) };
+}
+function resolveRoutedModel(model, providerName, session, includeUnqualified, deps, memory, rotations, needs) {
+  const models = deps.models?.(session);
   const qualified = model.includes("/") && !model.startsWith("acct:") ? model : void 0;
   if (qualified !== void 0) {
     const [provider2, ...rest2] = qualified.split("/");
     const named = rest2.join("/");
     return provider2 === void 0 || named === "" ? void 0 : { provider: provider2, model: withoutContextMarker(named), ref: qualified };
   }
-  const virtual = models?.virtual?.[model];
-  if (virtual === void 0 || !includeUnqualified) {
+  const isFamily = model.startsWith(FAMILY_PREFIX);
+  const virtual = isFamily ? void 0 : models?.virtual?.[model];
+  if (virtual === void 0 && !isFamily || !includeUnqualified) {
     return void 0;
   }
-  const members2 = expandMembers(model, models).filter((member) => !member.startsWith("acct:") && !member.startsWith("family:"));
+  const declared = isFamily ? [model] : expandMembers(model, models);
+  const families = isFamily || declared.some((member) => member.startsWith(FAMILY_PREFIX)) || models?.families !== void 0 ? buildFamilies(deps.targets?.() ?? [], models) : [];
+  const mode = virtual?.mode ?? familyMode(familyNamed(families, model)?.settings ?? {});
+  const members2 = expandFamilyMembers(declared, families).filter((member) => !member.startsWith("acct:"));
   if (members2.length === 0) {
     return void 0;
   }
   const snapshot = deps.usageSnapshotOf?.(session.identity);
   const current = memory.get(session.sessionId ?? "");
-  const candidates = members2.map((ref, order) => {
+  const evaluated = members2.map((ref, order) => {
     const [provider2] = ref.split("/");
     const facts = quotaFactsOf(snapshot?.providers[provider2 ?? ""]?.rateLimit?.unified, Date.now());
-    return candidateOf(ref, order, {
+    const candidate = candidateOf(ref, order, {
       quota: facts,
       ...deps.observations?.(ref) === void 0 ? {} : { observation: deps.observations(ref) },
       ...models?.prices?.[ref] === void 0 ? {} : { price: models.prices[ref] }
     }, ref === current);
+    return { candidate, capabilities: familyCapabilities(familyOfRef(families, ref)?.settings ?? {}) };
   });
-  const evaluated = candidates.map((candidate) => ({ candidate, capabilities: { vision: true, tools: true, thinking: true } }));
   const rotation = rotations.get(model) ?? 0;
   rotations.set(model, rotation + 1);
-  const selection = selectMember(virtual.mode, evaluated, { rotation });
+  const selection = selectMember(mode, evaluated, { rotation, ...needs === void 0 ? {} : { needs } });
   if (selection.ref === void 0) {
     return void 0;
   }
@@ -132011,6 +132114,7 @@ function createProviderRouteResolver(deps) {
     const serveScoped = (resolution) => scopedRequest === request7 ? resolution : { ok: true, route: servingRewritten(resolution.route, scopedRequest) };
     let current = scopedRequest;
     let replay;
+    let nameResolved = false;
     const visited = /* @__PURE__ */ new Set();
     for (; ; ) {
       const path65 = new URL(current.url, "http://127.0.0.1").pathname;
@@ -132032,7 +132136,7 @@ function createProviderRouteResolver(deps) {
         routes = void 0;
         isRouter = false;
       }
-      const routesByName = (isRouter || current.session.routeByName) && !isRcSelfHostPath(path65);
+      const routesByName = !nameResolved && (isRouter || current.session.routeByName) && !isRcSelfHostPath(path65);
       if (routesByName) {
         const scan2 = await scanRequestHead(current, true);
         if (scan2.replayed === void 0) {
@@ -132040,7 +132144,7 @@ function createProviderRouteResolver(deps) {
           return resolution.ok && replay !== void 0 ? { ok: true, route: servingRewritten(resolution.route, { ...replay, url: current.url }), request: { ...replay, url: current.url } } : resolution.ok ? serveScoped(resolution) : resolution;
         }
         replay = scan2.replayed;
-        const account = scan2.model === void 0 ? void 0 : resolveAccountTarget(scan2.model, deps.models?.());
+        const account = scan2.model === void 0 ? void 0 : resolveAccountTarget(scan2.model, deps.models?.(current.session));
         if (account !== void 0) {
           const sessionId = current.session.sessionId ?? "";
           const moved = sessionId !== "" && (deps.accountMoves?.(sessionId, account.identity, account.model) ?? false);
@@ -132050,7 +132154,7 @@ function createProviderRouteResolver(deps) {
             message: moved ? `model "${account.model}" runs under identity "${account.identity}"; this session is being moved there and will resume with it` : `model "${account.model}" runs under identity "${account.identity}", which needs a relaunch this session cannot make; start it there with: claude @${account.identity} --resume`
           };
         }
-        const routed = scan2.model === void 0 ? void 0 : resolveRoutedModel(scan2.model, providerName, current.session, isRouter || providerName !== void 0, deps, routingMemory, rotations);
+        const routed = scan2.model === void 0 ? void 0 : resolveRoutedModel(scan2.model, providerName, current.session, isRouter || providerName !== void 0, deps, routingMemory, rotations, needsOf(scan2));
         const requested = scan2.model;
         if (routed !== void 0) {
           routingMemory.set(current.session.sessionId ?? "", routed.ref);
@@ -132069,6 +132173,7 @@ function createProviderRouteResolver(deps) {
             const query2 = current.url.includes("?") ? current.url.slice(current.url.indexOf("?")) : "";
             const carried = replay;
             current = { ...current, url: `${PROVIDER_PATH_PREFIX}${encodeURIComponent(routed.provider)}${rest2}${query2}`, body: carried.body, headers: carried.headers };
+            nameResolved = true;
             continue;
           }
           const resolution = resolve2(current);
@@ -134555,6 +134660,9 @@ data: ${JSON.stringify(envelope)}
   };
 }
 
+// src/frontdoor/commands.ts
+init_targets();
+
 // src/frontdoor/rcStream.ts
 var RC_STREAM_EVENT_NAME2 = "client_event";
 var SSE_BYTE_ORDER_MARK = 65279;
@@ -135233,7 +135341,9 @@ function realFrontDoorSupervisorPorts(paths) {
   const resolveRoute = rcObservingResolver(
     createProviderRouteResolver({
       // Read live so a models-block edit reaches the next request without a door restart.
-      models: () => readModels(paths),
+      // The block this session launched with when its directory, profile or committed file added definitions of its own; otherwise the global block, read live so an edit applies to the next request with no relaunch.
+      models: (session) => (session.sessionId === void 0 ? void 0 : readFrontDoorSessionModels(realFarmFs, paths.frontdoorSessionsDir, session.sessionId)) ?? readModels(paths),
+      targets: () => targetRefs(paths),
       fs: realFsPort,
       providersDir: paths.providersDir,
       codexPorts,
@@ -147821,8 +147931,10 @@ function registerProviderCommand(program2, deps) {
 
 // src/models.ts
 init_commandDeps();
+init_targets();
 init_schema();
 init_cliError();
+init_families();
 init_identity2();
 init_modelsStore();
 init_realPorts();
@@ -147852,32 +147964,35 @@ function providerQuotaOf(paths) {
     return snapshot === void 0 ? {} : quotaFactsOf(snapshot.providers[provider]?.rateLimit?.unified, Date.now());
   };
 }
-function describeUnroutedMembers(members2) {
+function describeUnroutedMembers(members2, families) {
   return members2.flatMap((member) => {
     if (member.startsWith("acct:")) {
       const [identity] = member.slice("acct:".length).split("/");
       return [`${member} is served by relaunching the session under identity "${identity ?? ""}", so no quota signal ranks it`];
     }
-    return member.startsWith("family:") ? [`${member} is resolved from the live catalogues, which the door does not read yet, so it is not a candidate`] : [];
+    return member.startsWith(FAMILY_PREFIX) && familyNamed(families, member) === void 0 ? [`no target the providers offer belongs to ${member}, so it has nothing to choose among`] : [];
   });
 }
 function explainVirtualModel(paths, name) {
   const models = readModels(paths);
-  const definition = models?.virtual?.[name];
-  if (definition === void 0) {
+  const virtual = models?.virtual?.[name];
+  const families = buildFamilies(targetRefs(paths), models);
+  const isFamily = name.startsWith(FAMILY_PREFIX);
+  if (virtual === void 0 && !isFamily) {
     throw new UsageError(`No virtual model named "${name}".`);
   }
+  const mode = virtual?.mode ?? familyMode(familyNamed(families, name)?.settings ?? {});
   const quotaOf = providerQuotaOf(paths);
   const observations = createTargetObservationStore(realFarmFs, paths);
-  const members2 = expandMembers(name, models);
-  const candidates = members2.filter((member) => !member.startsWith("acct:") && !member.startsWith("family:")).map((ref, order) => {
+  const members2 = isFamily ? [name] : expandMembers(name, models);
+  const candidates = expandFamilyMembers(members2, families).filter((member) => !member.startsWith("acct:")).map((ref, order) => {
     const [provider] = ref.split("/");
     return candidateOf(ref, order, { quota: quotaOf(provider ?? ""), ...observations.observation(ref) === void 0 ? {} : { observation: observations.observation(ref) }, ...models?.prices?.[ref] === void 0 ? {} : { price: models.prices[ref] } }, false);
   });
-  const evaluated = candidates.map((candidate) => ({ candidate, capabilities: { vision: true, tools: true, thinking: true } }));
-  const selection = selectMember(definition.mode, evaluated, {});
-  const unrouted = describeUnroutedMembers(members2);
-  console.log(`${name} (${definition.mode}) chooses ${selection.ref ?? (candidates.length === 0 ? "nothing by quota" : "nothing")}:`);
+  const evaluated = candidates.map((candidate) => ({ candidate, capabilities: familyCapabilities(familyOfRef(families, candidate.ref)?.settings ?? {}) }));
+  const selection = selectMember(mode, evaluated, {});
+  const unrouted = describeUnroutedMembers(members2, families);
+  console.log(`${name} (${mode}) chooses ${selection.ref ?? (candidates.length === 0 ? "nothing by quota" : "nothing")}:`);
   for (const line of candidates.length === 0 ? unrouted : [...selection.reasons, ...unrouted]) {
     console.log(`  ${line}`);
   }
@@ -147909,7 +148024,7 @@ function registerModelsCommand(program2, deps) {
   const { paths } = deps;
   const modelsCommand = program2.command("model").description("Define and inspect the models the providers offer and the virtual models chosen among them.");
   withExamples(
-    modelsCommand.command("explain <name>").description("Show which member a virtual model's mode picks over the live signals, and why each candidate stands where it does.").action((name) => {
+    modelsCommand.command("explain <name>").description("Show which member a virtual model's (or a family row's) mode picks over the live signals, and why each candidate stands where it does.").action((name) => {
       explainVirtualModel(paths, name);
     }),
     ["agent-shim model explain fast"]