claude-use 11.40.5 → 11.42.0

package/dist/cli.cjs

@@ -26990,7 +26990,7 @@ function isTimeZone(name) {
     return false;
   }
 }
-var import_node_path4, CATEGORY_NAMES, OVERRIDABLE_CATEGORIES, CategoryMapSchema, DURATION_RE, DurationSchema, WhenConditionObjectSchema, WhenSchema, EntryValueSchema, ENTRY_KEY_RE, EntriesSchema, LaunchSchema, CREDENTIAL_TARGETS, PROVIDER_CREDENTIAL_TARGETS, CREDENTIAL_TARGET_VARS, ArgvSchema, CommandSourceOptions, EnvCredentialSourceSchema, FileCredentialSourceSchema, CommandCredentialSourceSchema, OpCredentialSourceSchema, KeychainCredentialSourceSchema, LiteralCredentialSourceSchema, CredentialSourceSchema, RemoteCredentialSourceSchema, CREDENTIAL_CACHE_STORES, CredentialCacheSchema, CredentialSchema, ProviderCredentialSchema, RESERVED_PROVIDER_ENV_KEYS, ProviderEnvSchema, PROVIDER_KINDS, ANTIGRAVITY_MODES, CLAUDE_TIERS, ANTIGRAVITY_EFFORTS, ANTIGRAVITY_DEFAULT_MODE, ANTIGRAVITY_DEFAULT_MODEL, ANTIGRAVITY_DEFAULT_TIER_MODELS, ANTIGRAVITY_DEFAULT_EFFORT, AntigravityModelTargetSchema, AntigravityProviderConfigSchema, CODEX_EFFORTS, CODEX_LOGINS, CODEX_DEFAULT_LOGIN, CODEX_DEFAULT_MODEL, CODEX_DEFAULT_TIER_MODELS, CODEX_DEFAULT_EFFORT, CodexProviderConfigSchema, ProviderRouteSchema, PickerModelSchema, PickerModelsSchema, ProviderCatalogueSchema, HttpProviderSchema, CodexProviderSchema, RouterProviderSchema, AntigravityProviderSchema, ProviderSchema, SELECTION_MODES, VirtualModelSchema, ModelPricesSchema, ModelsConfigSchema, ModelsLayerSchema, ConfigProfileSchema, POOL_SELECTOR_PREFIX, POOL_NAME_PATTERN, IDENTITY_NAME_PATTERN, PoolNameSchema, SELECTOR_RE, IdentitySelectorSchema, PoolMemberSchema, POOL_PREFERENCES, PoolPreferenceSchema, WHOLE_PERCENT_MAX, CompactAtUtilisationSchema, PoolSchema, WEEKDAYS, AnchorSchema, JOB_WINDOWS, JobTriggerSchema, JobTargetSchema, JobSchema, DirectoryRuleSchema, DirectoryRulesSchema, PortableConfigSchema, HEADROOM_MODES, HEADROOM_CCR_MODES, HEADROOM_ROLLOUT_CHANNELS, INTERCEPT_CHANNELS, READ_MATURATION_CHANNELS, HeadroomGlobalConfigObjectSchema, HeadroomGlobalConfigSchema, HEADROOM_DEFAULT_SOURCE, HEADROOM_DEFAULT_IDLE_SHUTDOWN_MINUTES, FRONTDOOR_DEFAULT_IDLE_SHUTDOWN_MINUTES, FrontDoorGlobalConfigSchema, UPDATE_MODES, UpdateGlobalConfigSchema, GlobalConfigSchema, IdentitySchema, CategoryClassificationSchema, CategoryClassificationOverlaySchema, SHIPPED_CATEGORY_DEFAULTS;
+var import_node_path4, CATEGORY_NAMES, OVERRIDABLE_CATEGORIES, CategoryMapSchema, DURATION_RE, DurationSchema, WhenConditionObjectSchema, WhenSchema, EntryValueSchema, ENTRY_KEY_RE, EntriesSchema, LaunchSchema, CREDENTIAL_TARGETS, PROVIDER_CREDENTIAL_TARGETS, CREDENTIAL_TARGET_VARS, ArgvSchema, CommandSourceOptions, EnvCredentialSourceSchema, FileCredentialSourceSchema, CommandCredentialSourceSchema, OpCredentialSourceSchema, KeychainCredentialSourceSchema, LiteralCredentialSourceSchema, CredentialSourceSchema, RemoteCredentialSourceSchema, CREDENTIAL_CACHE_STORES, CredentialCacheSchema, CredentialSchema, ProviderCredentialSchema, RESERVED_PROVIDER_ENV_KEYS, ProviderEnvSchema, PROVIDER_KINDS, ANTIGRAVITY_MODES, CLAUDE_TIERS, ANTIGRAVITY_EFFORTS, ANTIGRAVITY_DEFAULT_MODE, ANTIGRAVITY_DEFAULT_MODEL, ANTIGRAVITY_DEFAULT_TIER_MODELS, ANTIGRAVITY_DEFAULT_EFFORT, AntigravityModelTargetSchema, AntigravityProviderConfigSchema, CODEX_EFFORTS, CODEX_LOGINS, CODEX_DEFAULT_LOGIN, CODEX_DEFAULT_MODEL, CODEX_DEFAULT_TIER_MODELS, CODEX_DEFAULT_EFFORT, CodexProviderConfigSchema, ProviderRouteSchema, PickerModelSchema, PickerModelsSchema, ProviderCatalogueSchema, HttpProviderSchema, CodexProviderSchema, RouterProviderSchema, AntigravityProviderSchema, ProviderSchema, SELECTION_MODES, VirtualModelSchema, ModelPricesSchema, FamilySettingsSchema, ModelsConfigSchema, ModelsLayerSchema, ConfigProfileSchema, POOL_SELECTOR_PREFIX, POOL_NAME_PATTERN, IDENTITY_NAME_PATTERN, PoolNameSchema, SELECTOR_RE, IdentitySelectorSchema, PoolMemberSchema, POOL_PREFERENCES, PoolPreferenceSchema, WHOLE_PERCENT_MAX, CompactAtUtilisationSchema, PoolSchema, WEEKDAYS, AnchorSchema, JOB_WINDOWS, JobTriggerSchema, JobTargetSchema, JobSchema, DirectoryRuleSchema, DirectoryRulesSchema, PortableConfigSchema, HEADROOM_MODES, HEADROOM_CCR_MODES, HEADROOM_ROLLOUT_CHANNELS, INTERCEPT_CHANNELS, READ_MATURATION_CHANNELS, HeadroomGlobalConfigObjectSchema, HeadroomGlobalConfigSchema, HEADROOM_DEFAULT_SOURCE, HEADROOM_DEFAULT_IDLE_SHUTDOWN_MINUTES, FRONTDOOR_DEFAULT_IDLE_SHUTDOWN_MINUTES, FrontDoorGlobalConfigSchema, UPDATE_MODES, UpdateGlobalConfigSchema, GlobalConfigSchema, IdentitySchema, CategoryClassificationSchema, CategoryClassificationOverlaySchema, SHIPPED_CATEGORY_DEFAULTS;
 var init_schema = __esm({
   "src/config/schema.ts"() {
     "use strict";
@@ -27237,6 +27237,14 @@ var init_schema = __esm({
       input: external_exports.number().positive(),
       output: external_exports.number().positive()
     });
+    FamilySettingsSchema = external_exports.strictObject({
+      names: external_exports.array(external_exports.string().min(1)).optional(),
+      mode: external_exports.enum(SELECTION_MODES).optional(),
+      context: external_exports.number().int().positive().optional(),
+      vision: external_exports.boolean().optional(),
+      tools: external_exports.boolean().optional(),
+      thinking: external_exports.boolean().optional()
+    });
     ModelsConfigSchema = external_exports.strictObject({
       /** Virtual models, by name. */
       virtual: external_exports.record(external_exports.string().min(1), VirtualModelSchema).optional(),
@@ -27252,7 +27260,13 @@ var init_schema = __esm({
       /** Model refs hidden from the picker and from routing, whatever else names them. */
       hide: external_exports.array(external_exports.string().min(1)).optional(),
       /** When set, the only model refs visible; everything else is hidden. */
-      show: external_exports.array(external_exports.string().min(1)).optional()
+      show: external_exports.array(external_exports.string().min(1)).optional(),
+      /** Assertions that each group of refs is one model under several names, overriding what the names alone say. */
+      same: external_exports.array(external_exports.array(external_exports.string().min(1)).min(2)).optional(),
+      /** Assertions that each pair of refs is two models however alike their names look. */
+      distinct: external_exports.array(external_exports.tuple([external_exports.string().min(1), external_exports.string().min(1)])).optional(),
+      /** Per-family settings and the names the normaliser cannot know, by family key. */
+      families: external_exports.record(external_exports.string().min(1), FamilySettingsSchema).optional()
     });
     ModelsLayerSchema = external_exports.strictObject({
       virtual: external_exports.record(external_exports.string().min(1), external_exports.union([VirtualModelSchema, external_exports.null()])).optional(),
@@ -27264,7 +27278,10 @@ var init_schema = __esm({
       }).optional(),
       prices: external_exports.record(external_exports.string().min(1), external_exports.union([ModelPricesSchema, external_exports.null()])).optional(),
       hide: external_exports.array(external_exports.string().min(1)).optional(),
-      show: external_exports.array(external_exports.string().min(1)).optional()
+      show: external_exports.array(external_exports.string().min(1)).optional(),
+      same: external_exports.array(external_exports.array(external_exports.string().min(1)).min(2)).optional(),
+      distinct: external_exports.array(external_exports.tuple([external_exports.string().min(1), external_exports.string().min(1)])).optional(),
+      families: external_exports.record(external_exports.string().min(1), external_exports.union([FamilySettingsSchema, external_exports.null()])).optional()
     });
     ConfigProfileSchema = external_exports.strictObject({
       $schema: external_exports.string().optional(),
@@ -27511,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)}
@@ -27563,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`).
@@ -32125,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;
   }
@@ -32964,6 +33002,26 @@ function mergeModels(current, layer) {
   if (layer.show !== void 0) {
     pieces.show = layer.show;
   }
+  if (layer.same !== void 0) {
+    pieces.same = [...current?.same ?? [], ...layer.same.filter((group) => !(current?.same ?? []).some((known) => known.length === group.length && known.every((ref, index) => ref === group[index])))];
+  }
+  if (layer.distinct !== void 0) {
+    pieces.distinct = [...current?.distinct ?? [], ...layer.distinct.filter(([left, right]) => !(current?.distinct ?? []).some(([a10, b]) => a10 === left && b === right))];
+  }
+  if (layer.families !== void 0) {
+    const families = {};
+    for (const [key, settings2] of Object.entries(current?.families ?? {})) {
+      if (layer.families[key] === void 0) {
+        families[key] = settings2;
+      }
+    }
+    for (const [key, settings2] of Object.entries(layer.families)) {
+      if (settings2 !== null) {
+        families[key] = settings2;
+      }
+    }
+    pieces.families = families;
+  }
   const merged = modelsOf(pieces);
   return Object.keys(merged).length === 0 ? void 0 : merged;
 }
@@ -32973,7 +33031,10 @@ function modelsOf(pieces) {
     ...pieces.tiers === void 0 || Object.keys(pieces.tiers).length === 0 ? {} : { tiers: pieces.tiers },
     ...pieces.prices === void 0 || Object.keys(pieces.prices).length === 0 ? {} : { prices: pieces.prices },
     ...pieces.hide === void 0 || pieces.hide.length === 0 ? {} : { hide: [...pieces.hide] },
-    ...pieces.show === void 0 || pieces.show.length === 0 ? {} : { show: [...pieces.show] }
+    ...pieces.show === void 0 || pieces.show.length === 0 ? {} : { show: [...pieces.show] },
+    ...pieces.same === void 0 || pieces.same.length === 0 ? {} : { same: pieces.same.map((group) => [...group]) },
+    ...pieces.distinct === void 0 || pieces.distinct.length === 0 ? {} : { distinct: pieces.distinct.map(([left, right]) => [left, right]) },
+    ...pieces.families === void 0 || Object.keys(pieces.families).length === 0 ? {} : { families: pieces.families }
   };
 }
 var init_flatten = __esm({
@@ -34636,7 +34697,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "claude-use",
-      version: "11.40.5",
+      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>",
@@ -36211,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`);
@@ -36505,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);
@@ -36563,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.`);
@@ -62673,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);
@@ -62687,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}`;
@@ -62953,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,
@@ -63756,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;
@@ -63798,6 +64088,7 @@ var init_flags = __esm({
     init_envBool();
     init_cliError();
     init_conditions();
+    init_schema();
     init_credential();
     init_headers();
     init_capability();
@@ -64176,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) {
@@ -65443,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() };
   }
@@ -65459,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);
@@ -65524,6 +65690,156 @@ var init_providerCatalogue = __esm({
   }
 });
 
+// src/modelsStore.ts
+function readModels(paths) {
+  return readGlobalConfig(paths)?.models;
+}
+function writeModels(paths, models) {
+  const emptied = models !== void 0 && Object.keys(models).length === 0 ? void 0 : models;
+  applyPatch(paths.globalConfigFile, GlobalConfigSchema, { models: emptied }, { defaults: {} });
+}
+function stripEmpty(models) {
+  const kept = {};
+  if (models.virtual !== void 0 && Object.keys(models.virtual).length > 0) {
+    kept.virtual = models.virtual;
+  }
+  if (models.tiers !== void 0 && Object.keys(models.tiers).length > 0) {
+    kept.tiers = models.tiers;
+  }
+  if (models.prices !== void 0 && Object.keys(models.prices).length > 0) {
+    kept.prices = models.prices;
+  }
+  if (models.hide !== void 0 && models.hide.length > 0) {
+    kept.hide = models.hide;
+  }
+  if (models.show !== void 0 && models.show.length > 0) {
+    kept.show = models.show;
+  }
+  if (models.same !== void 0 && models.same.length > 0) {
+    kept.same = models.same;
+  }
+  if (models.distinct !== void 0 && models.distinct.length > 0) {
+    kept.distinct = models.distinct;
+  }
+  if (models.families !== void 0 && Object.keys(models.families).length > 0) {
+    kept.families = models.families;
+  }
+  return kept;
+}
+function memberKindOf(ref, models) {
+  if (ref.startsWith("acct:")) {
+    return "account";
+  }
+  if (ref.startsWith("family:")) {
+    return "family";
+  }
+  return models?.virtual !== void 0 && ref in models.virtual ? "virtual" : "provider";
+}
+function expandMembers(name, models) {
+  const virtual = models?.virtual ?? {};
+  const expanded = [];
+  const walk2 = (current, chain) => {
+    const nested = virtual[current];
+    if (nested !== void 0) {
+      if (chain.includes(current)) {
+        throw new Error(`virtual model cycle: ${[...chain, current].join(" -> ")}`);
+      }
+      for (const member of nested.members) {
+        walk2(member, [...chain, current]);
+      }
+      return;
+    }
+    if (!expanded.includes(current)) {
+      expanded.push(current);
+    }
+  };
+  const top = virtual[name];
+  if (top === void 0) {
+    throw new VirtualModelNotFoundError(name);
+  }
+  for (const member of top.members) {
+    walk2(member, [name]);
+  }
+  return expanded;
+}
+function setVirtualModel(paths, name, model) {
+  const current = readModels(paths) ?? {};
+  writeModels(paths, { ...current, virtual: { ...current.virtual ?? {}, [name]: model } });
+}
+function removeVirtualModel(paths, name) {
+  const current = readModels(paths);
+  if (current?.virtual?.[name] === void 0) {
+    throw new VirtualModelNotFoundError(name);
+  }
+  const virtual = Object.fromEntries(Object.entries(current.virtual ?? {}).filter(([existing]) => existing !== name));
+  writeModels(paths, stripEmpty({ ...current, virtual: Object.keys(virtual).length === 0 ? void 0 : virtual }));
+}
+function setPrice(paths, ref, prices) {
+  const current = readModels(paths) ?? {};
+  const priced = Object.fromEntries(Object.entries(current.prices ?? {}).filter(([existing]) => existing !== ref));
+  const next = prices === void 0 ? priced : { ...priced, [ref]: prices };
+  writeModels(paths, stripEmpty({ ...current, prices: Object.keys(next).length === 0 ? void 0 : next }));
+}
+function setTier(paths, tier, ref) {
+  const current = readModels(paths) ?? {};
+  const tiers = {};
+  const merged = { ...current.tiers ?? {}, [tier]: ref };
+  for (const [key, value2] of Object.entries(merged)) {
+    if (value2 !== void 0) {
+      tiers[key] = value2;
+    }
+  }
+  writeModels(paths, stripEmpty({ ...current, tiers: Object.keys(tiers).length === 0 ? void 0 : tiers }));
+}
+function addSameGroup(paths, refs) {
+  const current = readModels(paths) ?? {};
+  const overlapping = (current.same ?? []).filter((group) => group.some((ref) => refs.includes(ref)));
+  const rest = (current.same ?? []).filter((group) => !overlapping.includes(group));
+  const joined2 = [.../* @__PURE__ */ new Set([...overlapping.flat(), ...refs])];
+  writeModels(paths, stripEmpty({ ...current, same: [...rest, joined2] }));
+}
+function addDistinctPair(paths, left, right) {
+  const current = readModels(paths) ?? {};
+  const known = (current.distinct ?? []).some(([a10, b]) => a10 === left && b === right || a10 === right && b === left);
+  if (!known) {
+    writeModels(paths, stripEmpty({ ...current, distinct: [...current.distinct ?? [], [left, right]] }));
+  }
+}
+function removeAssertionsNaming(paths, ref) {
+  const current = readModels(paths);
+  if (current === void 0) {
+    return 0;
+  }
+  const same = (current.same ?? []).filter((group) => !group.includes(ref));
+  const distinct = (current.distinct ?? []).filter(([left, right]) => left !== ref && right !== ref);
+  const removed = (current.same ?? []).length - same.length + ((current.distinct ?? []).length - distinct.length);
+  if (removed > 0) {
+    writeModels(paths, stripEmpty({ ...current, same: same.length === 0 ? void 0 : same, distinct: distinct.length === 0 ? void 0 : distinct }));
+  }
+  return removed;
+}
+function setFamily(paths, key, settings2) {
+  const current = readModels(paths) ?? {};
+  const others = Object.fromEntries(Object.entries(current.families ?? {}).filter(([existing]) => existing !== key));
+  const next = settings2 === void 0 ? others : { ...others, [key]: settings2 };
+  writeModels(paths, stripEmpty({ ...current, families: Object.keys(next).length === 0 ? void 0 : next }));
+}
+var VirtualModelNotFoundError;
+var init_modelsStore = __esm({
+  "src/modelsStore.ts"() {
+    "use strict";
+    init_store();
+    init_schema();
+    init_configProfilesStore();
+    VirtualModelNotFoundError = class extends Error {
+      constructor(name) {
+        super(`No virtual model named "${name}".`);
+        this.name = "VirtualModelNotFoundError";
+      }
+    };
+  }
+});
+
 // src/launcher/modelPicker.ts
 function labelOf(model) {
   return withoutContextMarker(model);
@@ -65610,30 +65926,29 @@ 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 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 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 targets = expandFamilyMembers(safeExpand(name, models), families);
+    return [{ model: name, label: name, description: `Virtual (${definition.mode})`, behavesAs: handlingOf(targets) }];
   });
-  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))];
+  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);
@@ -65650,6 +65965,8 @@ var init_modelPicker = __esm({
     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",
@@ -65665,114 +65982,6 @@ var init_modelPicker = __esm({
   }
 });
 
-// src/modelsStore.ts
-function readModels(paths) {
-  return readGlobalConfig(paths)?.models;
-}
-function writeModels(paths, models) {
-  const emptied = models !== void 0 && Object.keys(models).length === 0 ? void 0 : models;
-  applyPatch(paths.globalConfigFile, GlobalConfigSchema, { models: emptied }, { defaults: {} });
-}
-function stripEmpty(models) {
-  const kept = {};
-  if (models.virtual !== void 0 && Object.keys(models.virtual).length > 0) {
-    kept.virtual = models.virtual;
-  }
-  if (models.tiers !== void 0 && Object.keys(models.tiers).length > 0) {
-    kept.tiers = models.tiers;
-  }
-  if (models.prices !== void 0 && Object.keys(models.prices).length > 0) {
-    kept.prices = models.prices;
-  }
-  if (models.hide !== void 0 && models.hide.length > 0) {
-    kept.hide = models.hide;
-  }
-  if (models.show !== void 0 && models.show.length > 0) {
-    kept.show = models.show;
-  }
-  return kept;
-}
-function memberKindOf(ref, models) {
-  if (ref.startsWith("acct:")) {
-    return "account";
-  }
-  if (ref.startsWith("family:")) {
-    return "family";
-  }
-  return models?.virtual !== void 0 && ref in models.virtual ? "virtual" : "provider";
-}
-function expandMembers(name, models) {
-  const virtual = models?.virtual ?? {};
-  const expanded = [];
-  const walk2 = (current, chain) => {
-    const nested = virtual[current];
-    if (nested !== void 0) {
-      if (chain.includes(current)) {
-        throw new Error(`virtual model cycle: ${[...chain, current].join(" -> ")}`);
-      }
-      for (const member of nested.members) {
-        walk2(member, [...chain, current]);
-      }
-      return;
-    }
-    if (!expanded.includes(current)) {
-      expanded.push(current);
-    }
-  };
-  const top = virtual[name];
-  if (top === void 0) {
-    throw new VirtualModelNotFoundError(name);
-  }
-  for (const member of top.members) {
-    walk2(member, [name]);
-  }
-  return expanded;
-}
-function setVirtualModel(paths, name, model) {
-  const current = readModels(paths) ?? {};
-  writeModels(paths, { ...current, virtual: { ...current.virtual ?? {}, [name]: model } });
-}
-function removeVirtualModel(paths, name) {
-  const current = readModels(paths);
-  if (current?.virtual?.[name] === void 0) {
-    throw new VirtualModelNotFoundError(name);
-  }
-  const virtual = Object.fromEntries(Object.entries(current.virtual ?? {}).filter(([existing]) => existing !== name));
-  writeModels(paths, stripEmpty({ ...current, virtual: Object.keys(virtual).length === 0 ? void 0 : virtual }));
-}
-function setPrice(paths, ref, prices) {
-  const current = readModels(paths) ?? {};
-  const priced = Object.fromEntries(Object.entries(current.prices ?? {}).filter(([existing]) => existing !== ref));
-  const next = prices === void 0 ? priced : { ...priced, [ref]: prices };
-  writeModels(paths, stripEmpty({ ...current, prices: Object.keys(next).length === 0 ? void 0 : next }));
-}
-function setTier(paths, tier, ref) {
-  const current = readModels(paths) ?? {};
-  const tiers = {};
-  const merged = { ...current.tiers ?? {}, [tier]: ref };
-  for (const [key, value2] of Object.entries(merged)) {
-    if (value2 !== void 0) {
-      tiers[key] = value2;
-    }
-  }
-  writeModels(paths, stripEmpty({ ...current, tiers: Object.keys(tiers).length === 0 ? void 0 : tiers }));
-}
-var VirtualModelNotFoundError;
-var init_modelsStore = __esm({
-  "src/modelsStore.ts"() {
-    "use strict";
-    init_store();
-    init_schema();
-    init_configProfilesStore();
-    VirtualModelNotFoundError = class extends Error {
-      constructor(name) {
-        super(`No virtual model named "${name}".`);
-        this.name = "VirtualModelNotFoundError";
-      }
-    };
-  }
-});
-
 // src/launcher/pool.ts
 function isResuming(passthrough) {
   const end = passthrough.indexOf(TERMINATOR3);
@@ -65972,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) {
@@ -66163,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 });
     }
@@ -66195,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");
@@ -66233,6 +66466,8 @@ function decideLaunch(params, readOnly) {
     identityCredential,
     pinnedVersion,
     flags,
+    models,
+    globalModels,
     bin: discovered.path,
     args,
     decision
@@ -66299,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);
@@ -66311,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);
   }
@@ -66325,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,
@@ -66337,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 = () => {
@@ -66399,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();
@@ -66420,7 +66659,6 @@ var init_launcher = __esm({
     init_launchReport();
     init_modelPicker();
     init_providerCatalogue();
-    init_modelsStore();
     init_providersStore();
     init_pool();
     init_resumeContext();
@@ -66438,6 +66676,7 @@ var init_launcher = __esm({
     init_read();
     init_claudeVersion();
     init_launchHook();
+    init_targets();
   }
 });
 
@@ -119737,6 +119976,8 @@ init_source();
 
 // src/models/doctor.ts
 init_modelsStore();
+init_families();
+init_identity2();
 function modelsFindings(input2) {
   const findings = [];
   const { models } = input2;
@@ -119781,6 +120022,38 @@ function modelsFindings(input2) {
       findings.push({ severity: "fail", message: `Tier ${tier} points at "${ref}", which names nothing defined.` });
     }
   }
+  const modelOfRef = (ref) => ref.slice(ref.indexOf("/") + 1);
+  for (const group of models.same ?? []) {
+    for (let outer = 0; outer < group.length; outer += 1) {
+      for (let inner = outer + 1; inner < group.length; inner += 1) {
+        const left = group[outer] ?? "";
+        const right = group[inner] ?? "";
+        if (!left.startsWith("acct:") && !right.startsWith("acct:") && relateModels(modelOfRef(left), modelOfRef(right)) === "distinct") {
+          findings.push({ severity: "warn", message: `"${left}" and "${right}" are asserted to be one model, but their names say they are different models; check the assertion is not a typo.` });
+        }
+        if ((models.distinct ?? []).some(([a10, b]) => a10 === left && b === right || a10 === right && b === left)) {
+          findings.push({ severity: "fail", message: `"${left}" and "${right}" are asserted to be both one model and two models.` });
+        }
+      }
+    }
+  }
+  for (const [name, model] of Object.entries(models.virtual ?? {})) {
+    const concrete = model.members.filter((member) => memberKindOf(member, models) === "provider" && member.includes("/"));
+    const looksAlike = concrete.flatMap((left, index) => concrete.slice(index + 1).filter((right) => relateModels(modelOfRef(left), modelOfRef(right)) === "same").map((right) => [left, right]));
+    for (const [left, right] of looksAlike) {
+      findings.push({ severity: "warn", message: `Virtual model "${name}" lists "${left}" and "${right}", which look like one model; a member ${FAMILY_PREFIX}${familyKeyOf(modelOfRef(left))} names every target of it.` });
+    }
+  }
+  if (input2.targets !== void 0) {
+    const families = buildFamilies(input2.targets, models);
+    for (const [name, model] of Object.entries(models.virtual ?? {})) {
+      for (const member of model.members.filter((entry) => entry.startsWith(FAMILY_PREFIX))) {
+        if (!families.some((family) => `${FAMILY_PREFIX}${family.key}` === member)) {
+          findings.push({ severity: "warn", message: `Virtual model "${name}" names ${member}, but no target the providers offer belongs to that family.` });
+        }
+      }
+    }
+  }
   const hidden = new Set(models.hide ?? []);
   const shown = new Set(models.show ?? []);
   for (const ref of hidden) {
@@ -119792,6 +120065,7 @@ function modelsFindings(input2) {
 }
 
 // src/doctorReport.ts
+init_targets();
 init_configProfilesStore();
 
 // src/headroom/allowlistDrift.ts
@@ -120344,7 +120618,7 @@ function runDoctor(params) {
     if (models === void 0) {
       push("models", "pass", "No models block configured.");
     } else {
-      for (const finding of modelsFindings({ models, providers: params.providers.map((entry) => entry.name), identities: params.identities.map((entry) => entry.name) })) {
+      for (const finding of modelsFindings({ models, providers: params.providers.map((entry) => entry.name), identities: params.identities.map((entry) => entry.name), ...params.modelTargets === void 0 ? {} : { targets: params.modelTargets } })) {
         push("models", finding.severity, finding.message);
       }
       push("models", "pass", "The models block is consistent.");
@@ -120578,6 +120852,7 @@ function collectDoctorReport(params) {
     directoryRules: { path: paths.directoryRulesFile, raw: realFsPort.readFileUtf8(paths.directoryRulesFile) },
     globalConfig: { path: paths.globalConfigFile, raw: realFsPort.readFileUtf8(paths.globalConfigFile) },
     models: parsedModelsOf(paths),
+    modelTargets: targetRefs(paths),
     categoriesLocal: { path: paths.categoriesLocalFile, raw: realFsPort.readFileUtf8(paths.categoriesLocalFile) },
     activeIdentity: { path: paths.activeIdentityFile, raw: realFsPort.readFileUtf8(paths.activeIdentityFile) },
     binaryDiscovery,
@@ -131547,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");
@@ -131637,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;
   }
@@ -131830,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;
@@ -131851,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) {
@@ -131859,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);
@@ -131869,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);
@@ -131888,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);
@@ -134374,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;
@@ -135052,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,
@@ -147640,12 +147931,10 @@ function registerProviderCommand(program2, deps) {
 
 // src/models.ts
 init_commandDeps();
-init_providersStore();
-init_modelPicker();
-init_providerCatalogue();
-init_realPorts();
+init_targets();
 init_schema();
 init_cliError();
+init_families();
 init_identity2();
 init_modelsStore();
 init_realPorts();
@@ -147675,52 +147964,46 @@ 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}`);
   }
 }
-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 matchModels(models) {
-  const same = [];
-  for (const model of models) {
-    const group = same.find((candidates) => candidates.some((other) => relateModels(other.model, model.model) === "same" && other.provider !== model.provider));
-    if (group === void 0) {
-      same.push([model]);
-    } else {
-      group.push(model);
-    }
-  }
+function matchModels(models, config2) {
+  const refOf = (model) => `${model.provider}/${model.model}`;
+  const byRef = new Map(models.map((model) => [refOf(model), model]));
+  const families = buildFamilies(models.map(refOf), config2);
+  const familyOf = new Map(families.flatMap((family) => family.refs.map((ref) => [ref, family])));
+  const same = families.map((family) => family.refs.flatMap((ref) => byRef.get(ref) ?? [])).filter((group) => new Set(group.map((entry) => entry.provider)).size > 1);
+  const distinct = config2?.distinct ?? [];
   const similar = [];
   for (let outer = 0; outer < models.length; outer += 1) {
     for (let inner = outer + 1; inner < models.length; inner += 1) {
@@ -147729,18 +148012,19 @@ function matchModels(models) {
       if (left === void 0 || right === void 0 || left.provider === right.provider) {
         continue;
       }
-      if (relateModels(left.model, right.model) === "similar" && !same.some((group) => group.includes(left) && group.includes(right))) {
+      const asserted = distinct.some(([a10, b]) => a10 === refOf(left) && b === refOf(right) || a10 === refOf(right) && b === refOf(left));
+      if (!asserted && familyOf.get(refOf(left)) !== familyOf.get(refOf(right)) && relateModels(left.model, right.model) === "similar") {
         similar.push([left, right]);
       }
     }
   }
-  return { same: same.filter((group) => group.length > 1), similar };
+  return { same, similar };
 }
 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"]
@@ -147751,7 +148035,7 @@ function registerModelsCommand(program2, deps) {
     ["agent-shim model match"]
   ).action((options) => {
     const models = providerModels(paths);
-    const { same, similar } = matchModels(models);
+    const { same, similar } = matchModels(models, readModels(paths));
     if (options.json === true) {
       printJson({ models, same, similar });
       return;
@@ -147830,7 +148114,53 @@ function registerModelsCommand(program2, deps) {
     console.log(options.clear === true ? `Removed prices for ${ref}.` : `Prices for ${ref}: ${String(options.input)} in, ${String(options.output)} out per million tokens.`);
   });
   withExamples(
-    modelsCommand.command("list").description("List the defined virtual models, the tier pointers and the visibility filter.").option("--json", "Print the models block as JSON."),
+    modelsCommand.command("same <ref> <ref...>").description("Assert that these refs are one model under several names, which makes them one family a mode can route across."),
+    ["agent-shim model same z/glm-5.1 o/zai-glm-51"]
+  ).action((first, rest) => {
+    addSameGroup(paths, [first, ...rest]);
+    console.log(`Asserted one model: ${[first, ...rest].join(" = ")}`);
+  });
+  withExamples(
+    modelsCommand.command("distinct <left> <right>").description("Assert that two refs are two models, however alike their names look, so they are never put in one family."),
+    ["agent-shim model distinct z/glm-5.1 s/hf:zai-org/GLM-5.1"]
+  ).action((left, right) => {
+    addDistinctPair(paths, left, right);
+    console.log(`Asserted two models: ${left} / ${right}`);
+  });
+  withExamples(
+    modelsCommand.command("unassert <ref>").description("Remove every identity assertion that names this ref."),
+    ["agent-shim model unassert z/glm-5.1"]
+  ).action((ref) => {
+    const removed = removeAssertionsNaming(paths, ref);
+    console.log(removed === 0 ? `No assertion names ${ref}.` : `Removed ${String(removed)} assertion${removed === 1 ? "" : "s"} naming ${ref}.`);
+  });
+  withExamples(
+    modelsCommand.command("family <key>").description("Set one family's own settings: how a row that selects the whole family chooses, the names the normaliser cannot know, and what every target of it can do.").option("--mode <mode>", "How a row selecting the whole family chooses among its targets.", (value2) => asMode(value2)).option("--name <ref>", "Pin a ref or bare model name into the family (repeatable).", collectRepeated).option("--context <tokens>", "The family's context window, in tokens.", (value2) => asPositiveInteger(value2)).option("--vision", "Every target of the family accepts images.").option("--no-vision", "No target of the family accepts images.").option("--tools", "Every target of the family accepts tools.").option("--no-tools", "No target of the family accepts tools.").option("--thinking", "Every target of the family thinks.").option("--no-thinking", "No target of the family thinks.").option("--clear", "Remove the family's settings instead."),
+    ["agent-shim model family glm-5-1 --mode cheapest --no-vision", "agent-shim model family claude-opus-5-5 --name o/opus-latest"]
+  ).action((key, options) => {
+    if (options.clear === true) {
+      setFamily(paths, key, void 0);
+      console.log(`Removed the settings of family ${key}.`);
+      return;
+    }
+    const existing = readModels(paths)?.families?.[key] ?? {};
+    const settings2 = {
+      ...existing,
+      ...options.mode === void 0 ? {} : { mode: options.mode },
+      ...options.name === void 0 ? {} : { names: [.../* @__PURE__ */ new Set([...existing.names ?? [], ...options.name])] },
+      ...options.context === void 0 ? {} : { context: options.context },
+      ...options.vision === void 0 ? {} : { vision: options.vision },
+      ...options.tools === void 0 ? {} : { tools: options.tools },
+      ...options.thinking === void 0 ? {} : { thinking: options.thinking }
+    };
+    if (Object.keys(settings2).length === 0) {
+      throw new UsageError("Nothing to set: pass --mode, --name, --context, a capability flag, or --clear.");
+    }
+    setFamily(paths, key, settings2);
+    console.log(`Family ${key}: ${JSON.stringify(settings2)}`);
+  });
+  withExamples(
+    modelsCommand.command("list").description("List the defined virtual models, the tier pointers, the visibility filter, the identity assertions and the family settings.").option("--json", "Print the models block as JSON."),
     ["agent-shim model list"]
   ).action((options) => {
     const found = readModels(paths);
@@ -147854,8 +148184,24 @@ function registerModelsCommand(program2, deps) {
     if (found.show !== void 0) {
       console.log(`visible only: ${found.show.join(", ")}`);
     }
+    for (const group of found.same ?? []) {
+      console.log(`same: ${group.join(" = ")}`);
+    }
+    for (const [left, right] of found.distinct ?? []) {
+      console.log(`distinct: ${left} / ${right}`);
+    }
+    for (const [key, settings2] of Object.entries(found.families ?? {})) {
+      console.log(`family ${key}: ${JSON.stringify(settings2)}`);
+    }
   });
 }
+function asPositiveInteger(value2) {
+  const parsed = Number(value2);
+  if (!Number.isInteger(parsed) || parsed <= 0) {
+    throw new UsageError(`"${value2}" is not a token count: pass a positive whole number.`);
+  }
+  return parsed;
+}
 function asMode(value2) {
   const mode = SELECTION_MODES.find((candidate) => candidate === value2);
   if (mode === void 0) {