claude-use 11.32.0 → 11.34.0

package/dist/cli.cjs

@@ -26973,6 +26973,9 @@ function isHttpProvider(provider) {
 function isCodexProvider(provider) {
   return provider.kind === "codex";
 }
+function isRouterProvider(provider) {
+  return provider.kind === "router";
+}
 function isAntigravityProvider(provider) {
   return provider.kind === "antigravity";
 }
@@ -26987,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, AntigravityProviderSchema, ProviderSchema, 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, 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";
@@ -27032,6 +27035,8 @@ var init_schema = __esm({
       delay: external_exports.string().regex(DURATION_RE, "must be a duration such as 5s or 500ms").optional(),
       /** Whether the launcher waits for a key press after its own output before it starts claude. Takes the place of `delay` when both are set. Applies only when a terminal is watching. */
       pause: external_exports.boolean().optional(),
+      /** Whether a provider session routes provider-qualified model names (`z/glm-5.3`, `auto`) through the `models` block to the provider that serves them, instead of sending every request to the launch provider. */
+      routeByName: external_exports.boolean().optional(),
       /** Whether the launcher's report, for a launch that picks from a pool, lists every member the pick ranked with why each stands where it does, and not only the member it picked. */
       explain: external_exports.boolean().optional()
     });
@@ -27092,7 +27097,7 @@ var init_schema = __esm({
     ProviderEnvSchema = external_exports.record(external_exports.string().min(1), external_exports.string()).refine((env) => !Object.keys(env).some((key) => RESERVED_PROVIDER_ENV_KEYS.includes(key)), {
       message: `env may not set ${RESERVED_PROVIDER_ENV_KEYS.join(", ")}: the credential block's target sets one and agent-shim removes the others`
     });
-    PROVIDER_KINDS = ["http", "codex", "antigravity"];
+    PROVIDER_KINDS = ["http", "codex", "antigravity", "router"];
     ANTIGRAVITY_MODES = ["cloud", "local"];
     CLAUDE_TIERS = ["fable", "opus", "sonnet", "haiku"];
     ANTIGRAVITY_EFFORTS = ["none", "low", "medium", "high", "xhigh", "max"];
@@ -27205,6 +27210,11 @@ var init_schema = __esm({
       pickerModels: PickerModelsSchema.optional(),
       codex: CodexProviderConfigSchema.optional()
     });
+    RouterProviderSchema = external_exports.strictObject({
+      $schema: external_exports.string().optional(),
+      kind: external_exports.literal("router"),
+      displayName: external_exports.string().min(1)
+    });
     AntigravityProviderSchema = external_exports.strictObject({
       $schema: external_exports.string().optional(),
       kind: external_exports.literal("antigravity"),
@@ -27215,14 +27225,55 @@ var init_schema = __esm({
       pickerModels: PickerModelsSchema.optional(),
       antigravity: AntigravityProviderConfigSchema.optional()
     });
-    ProviderSchema = external_exports.discriminatedUnion("kind", [HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema]);
+    ProviderSchema = external_exports.discriminatedUnion("kind", [HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema, RouterProviderSchema]);
+    SELECTION_MODES = ["ordered", "most-allowance", "soonest-reset", "spread", "adaptive", "lowest-latency", "highest-success", "cheapest"];
+    VirtualModelSchema = external_exports.strictObject({
+      /** How the virtual model chooses its member for a request. */
+      mode: external_exports.enum(SELECTION_MODES),
+      /** The members to choose among, in preference order where the mode reads order. Each names a target (`z/glm-5.3`), an account model (`acct:work/opus`), another virtual model, or a family (`family:<canonical>`). */
+      members: external_exports.array(external_exports.string().min(1)).min(1)
+    });
+    ModelPricesSchema = external_exports.strictObject({
+      input: external_exports.number().positive(),
+      output: external_exports.number().positive()
+    });
+    ModelsConfigSchema = external_exports.strictObject({
+      /** Virtual models, by name. */
+      virtual: external_exports.record(external_exports.string().min(1), VirtualModelSchema).optional(),
+      /** Which model ref each Claude tier (`fable`, `opus`, `sonnet`, `haiku`) points at: a concrete target, an account model, a virtual model, or a family. */
+      tiers: external_exports.strictObject({
+        fable: external_exports.string().min(1).optional(),
+        opus: external_exports.string().min(1).optional(),
+        sonnet: external_exports.string().min(1).optional(),
+        haiku: external_exports.string().min(1).optional()
+      }).optional(),
+      /** Prices per model ref, for the `cheapest` mode. */
+      prices: external_exports.record(external_exports.string().min(1), ModelPricesSchema).optional(),
+      /** 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()
+    });
+    ModelsLayerSchema = external_exports.strictObject({
+      virtual: external_exports.record(external_exports.string().min(1), external_exports.union([VirtualModelSchema, external_exports.null()])).optional(),
+      tiers: external_exports.strictObject({
+        fable: external_exports.union([external_exports.string().min(1), external_exports.null()]).optional(),
+        opus: external_exports.union([external_exports.string().min(1), external_exports.null()]).optional(),
+        sonnet: external_exports.union([external_exports.string().min(1), external_exports.null()]).optional(),
+        haiku: external_exports.union([external_exports.string().min(1), external_exports.null()]).optional()
+      }).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()
+    });
     ConfigProfileSchema = external_exports.strictObject({
       $schema: external_exports.string().optional(),
       description: external_exports.string().optional(),
       extends: external_exports.array(external_exports.string().min(1)).optional(),
       categories: CategoryMapSchema.optional(),
       entries: EntriesSchema.optional(),
-      launch: LaunchSchema.optional()
+      launch: LaunchSchema.optional(),
+      models: ModelsLayerSchema.optional()
     });
     POOL_SELECTOR_PREFIX = "pool:";
     POOL_NAME_PATTERN = "[A-Za-z0-9][A-Za-z0-9._-]*";
@@ -27333,6 +27384,7 @@ var init_schema = __esm({
       frontdoor: FrontDoorGlobalConfigSchema.optional(),
       update: UpdateGlobalConfigSchema.optional(),
       pools: external_exports.record(PoolNameSchema, PoolSchema).optional(),
+      models: ModelsConfigSchema.optional(),
       jobs: external_exports.record(PoolNameSchema, JobSchema).optional()
     });
     IdentitySchema = external_exports.strictObject({
@@ -31833,7 +31885,8 @@ function profileLayers(rootName, load, startId) {
       ...source.profile.categories === void 0 ? {} : { categories: source.profile.categories },
       ...source.profile.entries === void 0 ? {} : { entries: source.profile.entries },
       ...source.entryOrder === void 0 ? {} : { entryOrder: source.entryOrder },
-      ...source.profile.launch === void 0 ? {} : { launch: source.profile.launch }
+      ...source.profile.launch === void 0 ? {} : { launch: source.profile.launch },
+      ...source.profile.models === void 0 ? {} : { models: source.profile.models }
     });
     nextId += 1;
   }
@@ -31921,7 +31974,8 @@ function assembleCascade(input2) {
         ...source.config.categories === void 0 ? {} : { categories: source.config.categories },
         ...source.config.entries === void 0 ? {} : { entries: source.config.entries },
         ...source.entryOrder === void 0 ? {} : { entryOrder: source.entryOrder },
-        ...source.config.launch === void 0 ? {} : { launch: source.config.launch }
+        ...source.config.launch === void 0 ? {} : { launch: source.config.launch },
+        ...source.config.models === void 0 ? {} : { models: source.config.models }
       });
       nextId += 1;
     }
@@ -32539,6 +32593,7 @@ function flattenLayers(layers, options) {
   const rules = /* @__PURE__ */ new Map();
   const launch = {};
   const diagnostics = [];
+  let models;
   for (const layer of layers) {
     if (layer.categories !== void 0) {
       for (const [name, value2] of Object.entries(layer.categories)) {
@@ -32577,6 +32632,9 @@ function flattenLayers(layers, options) {
         launch.explain = layer.launch.explain;
       }
     }
+    if (layer.models !== void 0) {
+      models = mergeModels(models, layer.models);
+    }
     if (layer.entries === void 0) {
       continue;
     }
@@ -32639,7 +32697,7 @@ function flattenLayers(layers, options) {
       rules.set(pattern, rule);
     }
   }
-  return { categories, rules, launch, diagnostics };
+  return { categories, rules, launch, ...models === void 0 ? {} : { models }, diagnostics };
 }
 function orderedKeys(layer) {
   const present = new Set(Object.keys(layer.entries ?? {}));
@@ -32664,6 +32722,67 @@ function matchingRules(flattened, relPath) {
   }
   return matches.sort((a10, b) => compareSpecificity(b, a10));
 }
+function mergeModels(current, layer) {
+  const pieces = { ...current ?? {} };
+  if (layer.virtual !== void 0) {
+    const virtual = {};
+    for (const [name, definition] of Object.entries(current?.virtual ?? {})) {
+      if (layer.virtual[name] === void 0) {
+        virtual[name] = definition;
+      }
+    }
+    for (const [name, definition] of Object.entries(layer.virtual)) {
+      if (definition !== null) {
+        virtual[name] = definition;
+      }
+    }
+    pieces.virtual = virtual;
+  }
+  if (layer.tiers !== void 0) {
+    const tiers = {};
+    for (const tier of ["fable", "opus", "sonnet", "haiku"]) {
+      const ref = layer.tiers[tier];
+      const inherited = current?.tiers?.[tier];
+      if (ref !== null && ref !== void 0) {
+        tiers[tier] = ref;
+      } else if (ref === void 0 && inherited !== void 0) {
+        tiers[tier] = inherited;
+      }
+    }
+    pieces.tiers = tiers;
+  }
+  if (layer.prices !== void 0) {
+    const priced = {};
+    for (const [ref, prices] of Object.entries(current?.prices ?? {})) {
+      if (layer.prices[ref] === void 0) {
+        priced[ref] = prices;
+      }
+    }
+    for (const [ref, prices] of Object.entries(layer.prices)) {
+      if (prices !== null) {
+        priced[ref] = prices;
+      }
+    }
+    pieces.prices = priced;
+  }
+  if (layer.hide !== void 0) {
+    pieces.hide = layer.hide;
+  }
+  if (layer.show !== void 0) {
+    pieces.show = layer.show;
+  }
+  const merged = modelsOf(pieces);
+  return Object.keys(merged).length === 0 ? void 0 : merged;
+}
+function modelsOf(pieces) {
+  return {
+    ...pieces.virtual === void 0 || Object.keys(pieces.virtual).length === 0 ? {} : { virtual: pieces.virtual },
+    ...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] }
+  };
+}
 var init_flatten = __esm({
   "src/resolve/flatten.ts"() {
     "use strict";
@@ -34323,7 +34442,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "claude-use",
-      version: "11.32.0",
+      version: "11.34.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>",
@@ -36003,7 +36122,7 @@ function describeProviderEndpoint(provider) {
   if (isAntigravityProvider(provider)) {
     return (provider.antigravity?.mode ?? ANTIGRAVITY_DEFAULT_MODE) === "local" ? "antigravity local (ACP daemon)" : "antigravity cloud (Gemini API)";
   }
-  return provider.baseUrl;
+  return isRouterProvider(provider) ? "the models block" : provider.baseUrl;
 }
 function isEmptyCodexConfig(config2) {
   return config2 === void 0 || config2.defaultModel === void 0 && config2.effort === void 0 && config2.login === void 0 && (config2.models === void 0 || Object.keys(config2.models).length === 0);
@@ -36025,10 +36144,16 @@ function addProvider(paths, name, input2) {
   if (kind === "antigravity" && input2.baseUrl !== void 0) {
     throw new ProviderKindMismatchError("An antigravity provider has no base URL: the launcher points its sessions at the front-door daemon. Drop --base-url.");
   }
+  if (kind === "router" && input2.baseUrl !== void 0) {
+    throw new ProviderKindMismatchError("A router provider has no base URL: it resolves each request's model name through the models block. Drop --base-url.");
+  }
   if (kind === "http" && input2.baseUrl === void 0) {
     throw new ProviderKindMismatchError("An http provider needs --base-url.");
   }
-  if (kind !== "http" && input2.catalogue !== void 0) {
+  if (kind === "router" && (input2.sources.length > 0 || input2.target !== void 0 || input2.env !== void 0 || input2.pickerModels !== void 0)) {
+    throw new ProviderKindMismatchError("A router provider has no credential, env or picker models of its own: the models block's targets carry their own.");
+  }
+  if (kind !== "http" && kind !== "router" && input2.catalogue !== void 0) {
     throw new ProviderKindMismatchError("A model catalogue applies only to an http provider.");
   }
   if (kind !== "codex" && !isEmptyCodexConfig(input2.codex)) {
@@ -36044,7 +36169,7 @@ function addProvider(paths, name, input2) {
     ...input2.pickerModels === void 0 || input2.pickerModels.length === 0 ? {} : { pickerModels: input2.pickerModels }
   };
   const parsed = ProviderSchema.safeParse(
-    kind === "codex" ? { kind, ...shared, ...isEmptyCodexConfig(input2.codex) ? {} : { codex: input2.codex } } : kind === "antigravity" ? { kind, ...shared, ...isEmptyAntigravityConfig(input2.antigravity) ? {} : { antigravity: input2.antigravity } } : { ...shared, baseUrl: input2.baseUrl, ...input2.catalogue === void 0 ? {} : { catalogue: input2.catalogue } }
+    kind === "router" ? { kind, displayName: input2.displayName } : kind === "codex" ? { kind, ...shared, ...isEmptyCodexConfig(input2.codex) ? {} : { codex: input2.codex } } : kind === "antigravity" ? { kind, ...shared, ...isEmptyAntigravityConfig(input2.antigravity) ? {} : { antigravity: input2.antigravity } } : { ...shared, baseUrl: input2.baseUrl, ...input2.catalogue === void 0 ? {} : { catalogue: input2.catalogue } }
   );
   if (!parsed.success) {
     throw new ConfigValidationError(providerJsonPath(paths, name), parsed.error.issues);
@@ -36058,15 +36183,18 @@ function updateProvider(paths, name, input2) {
     throw new ProviderNotFoundError(name);
   }
   const unset = new Set(input2.unsetEnv);
-  const env = Object.fromEntries(Object.entries({ ...existing.env, ...input2.env }).filter(([key]) => !unset.has(key)));
+  const existingEnv = isRouterProvider(existing) ? {} : existing.env;
+  const env = Object.fromEntries(Object.entries({ ...existingEnv, ...input2.env }).filter(([key]) => !unset.has(key)));
   const unsetPicker = new Set(input2.unsetPickerModels);
   const added = new Map((input2.pickerModels ?? []).map((entry) => [entry.model, entry]));
+  const existingPicker = isRouterProvider(existing) ? [] : existing.pickerModels;
   const pickerModels = [
-    ...(existing.pickerModels ?? []).filter((entry) => !unsetPicker.has(entry.model)).map((entry) => added.get(entry.model) ?? entry),
-    ...[...added.values()].filter((entry) => !(existing.pickerModels ?? []).some((kept) => kept.model === entry.model))
+    ...(existingPicker ?? []).filter((entry) => !unsetPicker.has(entry.model)).map((entry) => added.get(entry.model) ?? entry),
+    ...[...added.values()].filter((entry) => !(existingPicker ?? []).some((kept) => kept.model === entry.model))
   ];
-  const target = input2.target ?? existing.credential.target;
-  const cache = input2.cache === void 0 ? existing.credential.cache : input2.cache === false ? void 0 : input2.cache;
+  const router = isRouterProvider(existing);
+  const target = router ? void 0 : input2.target ?? existing.credential.target;
+  const cache = router ? void 0 : input2.cache === void 0 ? existing.credential.cache : input2.cache === false ? void 0 : input2.cache;
   if (isCodexProvider(existing) && input2.baseUrl !== void 0) {
     throw new ProviderKindMismatchError(`Provider "${name}" is a codex provider, which has no base URL.`);
   }
@@ -36084,10 +36212,12 @@ function updateProvider(paths, name, input2) {
   }
   const shared = {
     ...input2.displayName === void 0 ? {} : { displayName: input2.displayName },
-    credential: {
-      sources: input2.sources ?? existing.credential.sources,
-      ...target === void 0 ? {} : { target },
-      ...cache === void 0 ? {} : { cache }
+    ...router ? {} : {
+      credential: {
+        sources: input2.sources ?? existing.credential.sources,
+        ...target === void 0 ? {} : { target },
+        ...cache === void 0 ? {} : { cache }
+      }
     },
     env: Object.keys(env).length === 0 ? void 0 : env,
     pickerModels: pickerModels.length === 0 ? void 0 : pickerModels
@@ -36107,6 +36237,8 @@ function updateProvider(paths, name, input2) {
       ...existing.antigravity?.models === void 0 && input2.antigravity?.models === void 0 ? {} : { models: { ...existing.antigravity?.models, ...input2.antigravity?.models } }
     };
     candidate = { ...existing, ...shared, antigravity: isEmptyAntigravityConfig(antigravity) ? void 0 : antigravity };
+  } else if (router) {
+    candidate = { kind: "router", ...shared };
   } else {
     const catalogue = input2.catalogue === void 0 ? existing.catalogue : input2.catalogue === false ? void 0 : input2.catalogue;
     candidate = { ...existing, ...shared, catalogue, ...input2.baseUrl === void 0 ? {} : { baseUrl: input2.baseUrl } };
@@ -36156,6 +36288,9 @@ function resolveProvider(params) {
     return selection;
   }
   const { name, definition } = selection.provider;
+  if (isRouterProvider(definition)) {
+    return { ok: true, provider: { name, definition, credential: { target: "bearer", token: "", source: { env: "AGENT_SHIM_ROUTER" }, warnings: [] } }, warnings: [] };
+  }
   if (params.credentials === void 0) {
     return { ok: false, status: 1, message: `agent-shim: provider ${name} needs its credential resolved, but this launcher has no credential port wired` };
   }
@@ -63361,7 +63496,7 @@ function buildEnv(params) {
     env.CLAUDE_CONFIG_DIR = import_node_path40.default.join(params.identitiesDir, params.resolvedIdentityName);
   }
   if (params.provider !== void 0) {
-    const providerEnv = params.provider.definition.env ?? {};
+    const providerEnv = params.provider.definition.kind !== void 0 && params.provider.definition.kind !== "http" ? {} : params.provider.definition.env ?? {};
     providerCustomHeaders = providerEnv.ANTHROPIC_CUSTOM_HEADERS;
     env.ANTHROPIC_BASE_URL = void 0;
     env.AGENT_SHIM_PROVIDER = params.provider.definition.displayName;
@@ -65065,8 +65200,8 @@ function catalogueRows(provider, models) {
   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) : httpRows(provider);
-  const declared = (provider.pickerModels ?? []).map(declaredRow);
+  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)));
@@ -65684,7 +65819,7 @@ function resolveLaunch(params) {
   });
   const credentialNames = decided.identityCredentialBlock === void 0 ? [] : Object.keys(credentialVariables(decided.identityCredentialBlock.target ?? "bearer", ""));
   const environment = [.../* @__PURE__ */ new Set([...Object.keys(built).filter((name) => built[name] !== env[name]), ...credentialNames])].sort();
-  const credential = decided.provider !== void 0 ? { subject: "provider", name: decided.provider.name, summary: summariseCredential(decided.provider.definition.credential) } : decided.identityCredentialBlock !== void 0 && decided.farmIdentity !== void 0 ? { subject: "identity", name: decided.farmIdentity, summary: summariseCredential(decided.identityCredentialBlock) } : void 0;
+  const credential = decided.provider !== void 0 ? isRouterProvider(decided.provider.definition) ? void 0 : { subject: "provider", name: decided.provider.name, summary: summariseCredential(decided.provider.definition.credential) } : decided.identityCredentialBlock !== void 0 && decided.farmIdentity !== void 0 ? { subject: "identity", name: decided.farmIdentity, summary: summariseCredential(decided.identityCredentialBlock) } : void 0;
   return {
     decision: decided.decision,
     flags: decided.flags,
@@ -66256,7 +66391,7 @@ function createProviderLookup(ports) {
     return {
       baseUrl,
       apiKey: () => {
-        const resolution = resolveCredential({ credential: definition.credential, env: ports.env, port: ports.credentials, subject: `provider ${name}` });
+        const resolution = resolveCredential({ credential: isRouterProvider(definition) ? { sources: [] } : definition.credential, env: ports.env, port: ports.credentials, subject: `provider ${name}` });
         if (!resolution.ok) {
           throw new Error(resolution.message);
         }
@@ -113623,11 +113758,12 @@ function cachedState(cacheEnv, owner, block2) {
 function buildCredentialReport(provider, identity, identityName, cacheEnv) {
   const identityCredential = identity?.credential === void 0 ? void 0 : summariseCredential(identity.credential);
   const identityCached = identity?.credential === void 0 || identityName === void 0 ? void 0 : cachedState(cacheEnv, `identity ${identityName}`, identity.credential);
-  const providerCached = provider?.definition === void 0 ? void 0 : cachedState(cacheEnv, `provider ${provider.name}`, provider.definition.credential);
+  const providerCredential = provider?.definition !== void 0 && !isRouterProvider(provider.definition) ? provider.definition.credential : void 0;
+  const providerCached = providerCredential === void 0 || provider === void 0 ? void 0 : cachedState(cacheEnv, `provider ${provider.name}`, providerCredential);
   return {
     applies: provider !== void 0 ? "provider" : identityCredential !== void 0 ? "identity" : "stored-login",
     ...provider === void 0 ? {} : {
-      provider: provider.problem === void 0 ? { name: provider.name, credential: summariseCredential(provider.definition.credential), ...providerCached === void 0 ? {} : { cached: providerCached } } : { name: provider.name, problem: provider.problem }
+      provider: provider.problem === void 0 ? { name: provider.name, ...providerCredential === void 0 ? {} : { credential: summariseCredential(providerCredential), ...providerCached === void 0 ? {} : { cached: providerCached } } } : { name: provider.name, problem: provider.problem }
     },
     ...identityCredential === void 0 ? {} : { identity: identityCredential },
     ...identityCached === void 0 ? {} : { identityCached }
@@ -113722,7 +113858,7 @@ function formatCheckReport(report) {
   const { credential } = report;
   if (credential.provider !== void 0) {
     lines.push(
-      `  Provider ${credential.provider.name}: ${credential.provider.credential === void 0 ? `unusable: ${credential.provider.problem}` : formatCredentialSummary(credential.provider.credential)}${credential.provider.cached === void 0 ? "" : `; ${formatCachedCredentialState(credential.provider.cached)}`}`
+      `  Provider ${credential.provider.name}: ${credential.provider.credential === void 0 ? `unusable: ${credential.provider.problem ?? ""}` : formatCredentialSummary(credential.provider.credential)}${credential.provider.cached === void 0 ? "" : `; ${formatCachedCredentialState(credential.provider.cached)}`}`
     );
   }
   if (credential.identity !== void 0) {
@@ -119011,6 +119147,162 @@ init_credentialCache();
 init_realCredentialCache();
 init_source();
 
+// src/modelsStore.ts
+init_store();
+init_schema();
+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;
+}
+var VirtualModelNotFoundError = class extends Error {
+  constructor(name) {
+    super(`No virtual model named "${name}".`);
+    this.name = "VirtualModelNotFoundError";
+  }
+};
+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 }));
+}
+
+// src/models/doctor.ts
+function modelsFindings(input2) {
+  const findings = [];
+  const { models } = input2;
+  const providers = new Set(input2.providers);
+  const identities = new Set(input2.identities);
+  const virtualNames = new Set(Object.keys(models.virtual ?? {}));
+  for (const [name, model] of Object.entries(models.virtual ?? {})) {
+    for (const member of model.members) {
+      const kind = memberKindOf(member, models);
+      if (kind === "provider" && !member.includes("/")) {
+        findings.push({ severity: "fail", message: `Virtual model "${name}" names member "${member}", which is neither a defined virtual model nor a provider model (a provider model is <provider>/<model>).` });
+      } else if (kind === "provider" && !providers.has(member.split("/")[0] ?? "")) {
+        findings.push({ severity: "fail", message: `Virtual model "${name}" names member "${member}", but no provider "${member.split("/")[0] ?? ""}" is defined.` });
+      }
+      if (kind === "virtual" && !virtualNames.has(member)) {
+        findings.push({ severity: "fail", message: `Virtual model "${name}" names member "${member}", but no virtual model "${member}" is defined.` });
+      }
+      if (kind === "account") {
+        const identity = member.slice("acct:".length).split("/")[0] ?? "";
+        if (!identities.has(identity)) {
+          findings.push({ severity: "fail", message: `Virtual model "${name}" names member "${member}", but no identity "${identity}" is defined.` });
+        }
+      }
+    }
+    try {
+      expandMembers(name, models);
+    } catch (error63) {
+      findings.push({ severity: "fail", message: `Virtual model "${name}" cannot be expanded: ${error63 instanceof Error ? error63.message : String(error63)}` });
+    }
+    if (model.mode === "cheapest") {
+      const expanded = expandMembers(name, models);
+      const unpriced = expanded.filter((member) => models.prices?.[member] === void 0 && memberKindOf(member, models) !== "virtual");
+      if (unpriced.length > 0) {
+        findings.push({ severity: "warn", message: `Virtual model "${name}" chooses by price, but no prices are set for: ${unpriced.join(", ")}.` });
+      }
+    }
+  }
+  for (const [tier, ref] of Object.entries(models.tiers ?? {})) {
+    const kind = memberKindOf(ref, models);
+    const known = kind === "virtual" ? virtualNames.has(ref) : kind === "provider" ? providers.has(ref.split("/")[0] ?? "") : true;
+    if (!known) {
+      findings.push({ severity: "fail", message: `Tier ${tier} points at "${ref}", which names nothing defined.` });
+    }
+  }
+  const hidden = new Set(models.hide ?? []);
+  const shown = new Set(models.show ?? []);
+  for (const ref of hidden) {
+    if (shown.has(ref)) {
+      findings.push({ severity: "fail", message: `Model ref "${ref}" is both hidden and in the show-only list.` });
+    }
+  }
+  return findings;
+}
+
 // src/headroom/allowlistDrift.ts
 init_earlierRelease();
 init_state2();
@@ -119197,7 +119489,8 @@ var DOCTOR_SECTIONS = [
   "categories-local",
   "active-identity",
   "headroom",
-  "frontdoor"
+  "frontdoor",
+  "models"
 ];
 function refinePathShadow(status, ownExecutablePath, realpath) {
   if (status.status !== "shadowed") {
@@ -119320,9 +119613,11 @@ function pushProvider(push, entry, cacheEnv, signIn) {
   if (validated2.ignored.length > 0) {
     push("provider", "warn", describeIgnoredKeys(entry.path, validated2.ignored), entry.name);
   }
-  const cache = cacheClause(cacheEnv, `provider ${entry.name}`, validated2.data.credential);
-  push("provider", cache.unreadable ? "fail" : "pass", `${entry.name} is valid (${describeProviderEndpoint(validated2.data)}, credential ${describeCredential(validated2.data.credential)})${cache.text}.`, entry.name);
-  if (validated2.data.env?.ENABLE_TOOL_SEARCH === void 0) {
+  const router = isRouterProvider(validated2.data);
+  const noCache = { unreadable: false, text: "" };
+  const cache = router ? noCache : cacheClause(cacheEnv, `provider ${entry.name}`, validated2.data.credential);
+  push("provider", cache.unreadable ? "fail" : "pass", router ? `${entry.name} is valid (${describeProviderEndpoint(validated2.data)})` : `${entry.name} is valid (${describeProviderEndpoint(validated2.data)}, credential ${describeCredential(validated2.data.credential)})${cache.text}.`, entry.name);
+  if (!router && validated2.data.env?.ENABLE_TOOL_SEARCH === void 0) {
     push("provider", "warn", `${entry.name} does not set ENABLE_TOOL_SEARCH: a session on this provider keeps Claude Code's own API as its base URL, so it defers MCP tool loading and sends tool_reference payloads the upstream backend must understand. Set ENABLE_TOOL_SEARCH=false in the provider's env block to load tools upfront instead, when the backend does not support them.`, entry.name);
   }
   if (signIn !== void 0 && isCodexProvider(validated2.data) && validated2.data.codex?.login === "chatgpt-sign-in") {
@@ -119349,6 +119644,9 @@ function pushLegacyName(push, params) {
     );
   }
 }
+function parsedModelsOf(paths) {
+  return readGlobalConfig(paths)?.models;
+}
 function runDoctor(params) {
   const findings = [];
   const push = (section, severity, message, subject) => {
@@ -119550,6 +119848,17 @@ function runDoctor(params) {
       }
     }
   }
+  {
+    const models = params.models;
+    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) })) {
+        push("models", finding.severity, finding.message);
+      }
+      push("models", "pass", "The models block is consistent.");
+    }
+  }
   if (params.categoriesLocal.raw === void 0) {
     push("categories-local", "pass", "No categories.local.json configured.");
   } else {
@@ -119644,6 +119953,7 @@ function runDoctor(params) {
   return { findings, ok: !findings.some((finding) => finding.severity === "fail") };
 }
 var SECTION_TITLES = {
+  models: "Virtual models",
   "ambient-credential": "Ambient-credential exposure",
   "binary-discovery": "Claude Code binary discovery",
   "claude-shim": "`claude` command shim",
@@ -119776,6 +120086,7 @@ function collectDoctorReport(params) {
     providers,
     directoryRules: { path: paths.directoryRulesFile, raw: realFsPort.readFileUtf8(paths.directoryRulesFile) },
     globalConfig: { path: paths.globalConfigFile, raw: realFsPort.readFileUtf8(paths.globalConfigFile) },
+    models: parsedModelsOf(paths),
     categoriesLocal: { path: paths.categoriesLocalFile, raw: realFsPort.readFileUtf8(paths.categoriesLocalFile) },
     activeIdentity: { path: paths.activeIdentityFile, raw: realFsPort.readFileUtf8(paths.activeIdentityFile) },
     binaryDiscovery,
@@ -125209,7 +125520,7 @@ var CachedCredentialStateSchema = external_exports.union([
   external_exports.strictObject({ store: external_exports.enum(CREDENTIAL_CACHE_STORES), status: external_exports.enum(["fresh", "expired"]), ageMs: external_exports.number(), expiresInMs: external_exports.number().optional() })
 ]);
 var CheckCredentialProviderSchema = external_exports.union([
-  external_exports.strictObject({ name: external_exports.string(), credential: CredentialSummarySchema, cached: CachedCredentialStateSchema.optional() }),
+  external_exports.strictObject({ name: external_exports.string(), credential: CredentialSummarySchema.optional(), cached: CachedCredentialStateSchema.optional() }),
   external_exports.strictObject({ name: external_exports.string(), problem: external_exports.string() })
 ]);
 var CheckCredentialSchema = external_exports.strictObject({
@@ -127858,7 +128169,7 @@ var ProviderValueSchema = external_exports.strictObject({
   displayName: external_exports.string(),
   baseUrl: external_exports.string().optional(),
   codex: CodexProviderConfigSchema.optional(),
-  credential: CredentialSummarySchema2,
+  credential: CredentialSummarySchema2.optional(),
   env: external_exports.record(external_exports.string(), external_exports.string()).optional()
 });
 var ConfigNameInputSchema = external_exports.strictObject({ name: external_exports.string().min(1) });
@@ -128008,9 +128319,8 @@ function providerValue(name, provider) {
     name,
     kind: provider.kind ?? "http",
     displayName: provider.displayName,
-    ...isCodexProvider(provider) ? provider.codex === void 0 ? {} : { codex: provider.codex } : isAntigravityProvider(provider) ? provider.antigravity === void 0 ? {} : { antigravity: provider.antigravity } : { baseUrl: provider.baseUrl },
-    credential: summariseCredential(provider.credential),
-    ...provider.env === void 0 ? {} : { env: provider.env }
+    ...isCodexProvider(provider) ? provider.codex === void 0 ? {} : { codex: provider.codex } : isAntigravityProvider(provider) ? provider.antigravity === void 0 ? {} : { antigravity: provider.antigravity } : isRouterProvider(provider) ? {} : { baseUrl: provider.baseUrl },
+    ...isRouterProvider(provider) ? {} : { credential: summariseCredential(provider.credential), ...provider.env === void 0 ? {} : { env: provider.env } }
   };
 }
 function profileValue(name, paths) {
@@ -128192,7 +128502,7 @@ function createConfigApiRouter(deps) {
             if (input2.baseUrl !== void 0 && isHttpProvider(existing) && input2.baseUrl !== existing.baseUrl && credential?.sources === void 0) {
               throw new ORPCError("BAD_REQUEST", { message: `Changing the base URL of provider "${input2.name}" requires a credential block in the same call: the stored credential is not sent to a different endpoint.` });
             }
-            const cache = credential?.cache === void 0 ? void 0 : mergeCredentialCache(credential.cache === false ? { enabled: false } : { ...credential.cache, enabled: true }, existing.credential.cache);
+            const cache = credential?.cache === void 0 || isRouterProvider(existing) ? void 0 : mergeCredentialCache(credential.cache === false ? { enabled: false } : { ...credential.cache, enabled: true }, isRouterProvider(existing) ? void 0 : existing.credential.cache);
             const updated = updateProvider(paths, input2.name, {
               ...input2.displayName === void 0 ? {} : { displayName: input2.displayName },
               ...input2.baseUrl === void 0 ? {} : { baseUrl: input2.baseUrl },
@@ -130798,6 +131108,20 @@ function scopeSessionProviderPath(request7) {
   }
   return { ...request7, url: `${PROVIDER_PATH_PREFIX}${encodeURIComponent(request7.session.provider)}${request7.url}` };
 }
+function resolveModelTarget(model, models) {
+  if (models === void 0) {
+    return model.includes("/") && !model.startsWith("acct:") ? model.split("/")[0] : void 0;
+  }
+  if (model.includes("/") && !model.startsWith("acct:")) {
+    return model.split("/")[0];
+  }
+  const virtual = models.virtual?.[model];
+  const first = virtual?.members.find((member) => !member.startsWith("acct:") && !member.startsWith("family:"));
+  if (first === void 0) {
+    return void 0;
+  }
+  return first.includes("/") ? first.split("/")[0] : resolveModelTarget(first, models);
+}
 function createProviderRouteResolver(deps) {
   const oauthRoute = createPassthroughRoute("anthropic", { baseUrl: `https://${CONNECT_INTERCEPT_HOST}:${String(HTTPS_PORT)}`, stripPrefix: void 0, headroomUpstream: void 0 });
   const antigravityQuotaSources = /* @__PURE__ */ new Map();
@@ -130910,6 +131234,9 @@ function createProviderRouteResolver(deps) {
         )
       };
     }
+    if (isRouterProvider(definition)) {
+      return { ok: true, route: passthroughFor(`router:${provider}`, { baseUrl: `http://127.0.0.1:${String(deps.directPort())}`, stripPrefix: `${PROVIDER_PATH_PREFIX}${encodeURIComponent(provider)}`, headroomUpstream: directOrigin2(deps.directPort()) }) };
+    }
     const httpProvider = definition;
     return {
       ok: true,
@@ -130949,11 +131276,28 @@ function createProviderRouteResolver(deps) {
         visited.add(providerName);
       }
       let routes;
+      let isRouter;
       try {
         const definition = providerName === void 0 ? void 0 : loadProvider(deps.providersDir, providerName, deps.fs);
         routes = definition === void 0 || !isHttpProvider(definition) ? void 0 : definition.routes;
+        isRouter = definition !== void 0 && isRouterProvider(definition);
       } catch {
         routes = void 0;
+        isRouter = false;
+      }
+      if (isRouter) {
+        const scan2 = await scanRequestHead(current, false);
+        if (scan2.replayed !== void 0) {
+          replay = scan2.replayed;
+        }
+        const target = scan2.model === void 0 ? void 0 : resolveModelTarget(scan2.model, deps.models?.());
+        if (target !== void 0) {
+          const rest2 = path65.slice(`${PROVIDER_PATH_PREFIX}${encodeURIComponent(providerName ?? "")}`.length);
+          const query2 = current.url.includes("?") ? current.url.slice(current.url.indexOf("?")) : "";
+          const carried = scan2.replayed ?? current;
+          current = { ...current, url: `${PROVIDER_PATH_PREFIX}${encodeURIComponent(target)}${rest2}${query2}`, body: carried.body, headers: carried.headers };
+          continue;
+        }
       }
       if (routes === void 0 || routes.length === 0) {
         const resolution = resolve2(current);
@@ -134171,6 +134515,8 @@ function realFrontDoorSupervisorPorts(paths) {
   const rcControlToken = (0, import_node_crypto25.randomUUID)();
   const resolveRoute = rcObservingResolver(
     createProviderRouteResolver({
+      // Read live so a models-block edit reaches the next request without a door restart.
+      models: () => readModels(paths),
       fs: realFsPort,
       providersDir: paths.providersDir,
       codexPorts,
@@ -145433,6 +145779,7 @@ function registerCompletionCommand(program2) {
 var import_node_child_process8 = require("node:child_process");
 init_commandDeps();
 init_cliError();
+init_schema();
 init_credential();
 init_credentialCache();
 
@@ -145501,6 +145848,9 @@ function credentialSubject(deps, name, asProvider) {
     if (provider === void 0) {
       throw new ProviderNotFoundError(name);
     }
+    if (isRouterProvider(provider)) {
+      throw new UsageError(`Provider "${name}" is a router: it has no credential of its own.`);
+    }
     return { name, subject: `provider ${name}`, credential: provider.credential };
   }
   const identity = readIdentity(deps.paths, name);
@@ -146539,11 +146889,11 @@ function toProviderView(name, provider) {
     name,
     kind: provider.kind ?? "http",
     displayName: provider.displayName,
-    ...isCodexProvider(provider) ? provider.codex === void 0 ? {} : { codex: provider.codex } : isAntigravityProvider(provider) ? provider.antigravity === void 0 ? {} : { antigravity: provider.antigravity } : { baseUrl: provider.baseUrl },
-    credential: summariseCredential(provider.credential),
-    ...provider.env === void 0 ? {} : { env: provider.env },
-    ...provider.pickerModels === void 0 ? {} : { pickerModels: provider.pickerModels },
-    ...isCodexProvider(provider) || isAntigravityProvider(provider) || provider.catalogue === void 0 ? {} : { catalogue: provider.catalogue }
+    ...isCodexProvider(provider) ? provider.codex === void 0 ? {} : { codex: provider.codex } : isAntigravityProvider(provider) ? provider.antigravity === void 0 ? {} : { antigravity: provider.antigravity } : isRouterProvider(provider) ? {} : { baseUrl: provider.baseUrl },
+    ...isRouterProvider(provider) ? {} : { credential: summariseCredential(provider.credential) },
+    ...!isRouterProvider(provider) && provider.env !== void 0 ? { env: provider.env } : {},
+    ...!isRouterProvider(provider) && provider.pickerModels !== void 0 ? { pickerModels: provider.pickerModels } : {},
+    ...isCodexProvider(provider) || isAntigravityProvider(provider) || isRouterProvider(provider) || provider.catalogue === void 0 ? {} : { catalogue: provider.catalogue }
   };
 }
 function antigravityConfigFromOptions(options) {
@@ -146651,7 +147001,7 @@ function registerProviderCommand(program2, deps) {
         ...antigravity === void 0 ? {} : { antigravity }
       });
       reportMutation(options.json, { action: "created", kind: "provider", name, value: created }, () => {
-        console.log(`Created provider "${name}" (${describeProviderEndpoint(created)}, credential ${describeCredential(created.credential)}).`);
+        console.log(`Created provider "${name}" (${describeProviderEndpoint(created)}${isRouterProvider(created) ? "" : `, credential ${describeCredential(created.credential)}`}).`);
       });
     }),
     [
@@ -146685,12 +147035,13 @@ function registerProviderCommand(program2, deps) {
       }
       const codex = codexConfigFromOptions(options);
       const antigravity = antigravityConfigFromOptions(options);
-      const cache = cacheChange(options, readProvider(paths, name)?.credential.cache);
+      const existingForCache = readProvider(paths, name);
+      const cache = cacheChange(options, existingForCache !== void 0 && !isRouterProvider(existingForCache) ? existingForCache.credential.cache : void 0);
       if (options.unsetCatalogue === true && hasCatalogueOptions(options)) {
         throw new UsageError("--unset-catalogue cannot be combined with another --catalogue option.");
       }
       const existingProvider = readProvider(paths, name);
-      const catalogue = options.unsetCatalogue === true ? false : catalogueFromOptions(options, existingProvider !== void 0 && !isCodexProvider(existingProvider) && !isAntigravityProvider(existingProvider) ? existingProvider.catalogue : void 0);
+      const catalogue = options.unsetCatalogue === true ? false : catalogueFromOptions(options, existingProvider !== void 0 && !isCodexProvider(existingProvider) && !isAntigravityProvider(existingProvider) && !isRouterProvider(existingProvider) ? existingProvider.catalogue : void 0);
       const updated = updateProvider(paths, name, {
         ...codex === void 0 ? {} : { codex },
         ...antigravity === void 0 ? {} : { antigravity },
@@ -146706,7 +147057,7 @@ function registerProviderCommand(program2, deps) {
         ...catalogue === void 0 ? {} : { catalogue }
       });
       reportMutation(json2, { action: "updated", kind: "provider", name, value: updated }, () => {
-        console.log(`Updated provider "${name}" (${describeProviderEndpoint(updated)}, credential ${describeCredential(updated.credential)}).`);
+        console.log(`Updated provider "${name}" (${describeProviderEndpoint(updated)}${isRouterProvider(updated) ? "" : `, credential ${describeCredential(updated.credential)}`}).`);
       });
     }),
     [
@@ -146764,16 +147115,18 @@ function registerProviderCommand(program2, deps) {
         console.log(`Antigravity effort: ${config2.effort}`);
         console.log(`Antigravity degrade down tiers: ${config2.degradeDownTiers ? "on" : "off"}`);
         console.log(`Endpoint: ${describeProviderEndpoint(found)}`);
-      } else {
+      } else if (!isRouterProvider(found)) {
         console.log(`Base URL: ${found.baseUrl}`);
       }
-      console.log(`Credential: ${describeCredential(found.credential)}`);
-      const env = Object.entries(found.env ?? {});
+      if (!isRouterProvider(found)) {
+        console.log(`Credential: ${describeCredential(found.credential)}`);
+      }
+      const env = Object.entries(isRouterProvider(found) ? {} : found.env ?? {});
       console.log(`Environment: ${env.length === 0 ? "(none)" : env.map(([key, value2]) => `${key}=${value2}`).join(", ")}`);
-      if (found.pickerModels !== void 0) {
+      if (!isRouterProvider(found) && found.pickerModels !== void 0) {
         console.log(`Picker models: ${found.pickerModels.map((entry) => `${entry.model} (${entry.tier})`).join(", ")}`);
       }
-      if (!isCodexProvider(found) && !isAntigravityProvider(found) && found.catalogue !== void 0) {
+      if (!isCodexProvider(found) && !isAntigravityProvider(found) && !isRouterProvider(found) && found.catalogue !== void 0) {
         const { tier, include, exclude, url: url2 } = found.catalogue;
         console.log(`Catalogue: tier ${tier}${include === void 0 ? "" : `, include ${include.join(" ")}`}${exclude === void 0 ? "" : `, exclude ${exclude.join(" ")}`}${url2 === void 0 ? "" : `, url ${url2}`} (see \`provider models ${name}\`)`);
       }
@@ -146786,7 +147139,7 @@ function registerProviderCommand(program2, deps) {
       if (found === void 0) {
         throw new ProviderNotFoundError(name);
       }
-      if (isCodexProvider(found) || isAntigravityProvider(found) || found.catalogue === void 0) {
+      if (isCodexProvider(found) || isAntigravityProvider(found) || isRouterProvider(found) || found.catalogue === void 0) {
         throw new UsageError(`Provider "${name}" has no catalogue setting. Set one with \`agent-shim provider set ${name} --catalogue-tier <tier>\`.`);
       }
       const catalogueSetting = found.catalogue;
@@ -146828,6 +147181,8 @@ init_providersStore();
 init_modelPicker();
 init_providerCatalogue();
 init_realPorts();
+init_schema();
+init_cliError();
 
 // src/models/identity.ts
 var NON_IDENTITY_BRACKET_RE = /\[[^\]]*\]/g;
@@ -146978,8 +147333,8 @@ function matchModels(models) {
 }
 function registerModelsCommand(program2, deps) {
   const { paths } = deps;
-  const modelsCommand = program2.command("model").description("Inspect the models the defined providers offer: which names are the same model across providers, and which only look alike.");
-  withExamples(modelsCommand, ["agent-shim model match"]);
+  const modelsCommand = program2.command("model").description("Define and inspect the models the providers offer and the virtual models chosen among them.");
+  withExamples(modelsCommand, ["agent-shim model match", "agent-shim model add fast --mode soonest-reset --member z/glm-5.3 --member m/MiniMax-M3"]);
   withExamples(
     modelsCommand.command("match").description("List every model every provider offers, grouped into the ones that are the same model across providers, with the pairs that are merely similar named beside them.").option("--json", "Print the match as JSON."),
     ["agent-shim model match"]
@@ -147002,6 +147357,114 @@ function registerModelsCommand(program2, deps) {
       console.log(`  similar: ${left.provider}/${left.model} ~ ${right.provider}/${right.model}`);
     }
   });
+  withExamples(
+    modelsCommand.command("add <name>").description("Define a virtual model: a named choice over members, taken by its mode.").requiredOption("--mode <mode>", "How the virtual model chooses its member.", (value2) => asMode(value2)).option("--member <ref>", "One member it chooses among: a provider model (z/glm-5.3), an account model (acct:work/opus), another virtual model, or a family (family:<canonical>). Repeatable; order is the preference where the mode reads it.", collectRepeated),
+    ["agent-shim model add fast --mode soonest-reset --member z/glm-5.3 --member m/MiniMax-M3"]
+  ).action((name, options) => {
+    if (options.member === void 0 || options.member.length === 0) {
+      throw new UsageError("A virtual model needs at least one member: pass --member <ref> (repeatable).");
+    }
+    setVirtualModel(paths, name, { mode: options.mode, members: options.member });
+    console.log(`Defined virtual model "${name}" (${options.mode}): ${options.member.join(", ")}`);
+  });
+  withExamples(
+    modelsCommand.command("set <name>").description("Change a virtual model's mode or replace its member list; members not named are kept.").option("--mode <mode>", "The new mode.", (value2) => asMode(value2)).option("--member <ref>", "Add or replace one member (repeatable).", collectRepeated),
+    ["agent-shim model set fast --mode most-allowance"]
+  ).action((name, options) => {
+    const existing = readModels(paths)?.virtual?.[name];
+    if (existing === void 0) {
+      throw new VirtualModelNotFoundError(name);
+    }
+    if (options.mode === void 0 && options.member === void 0) {
+      throw new UsageError("Nothing to change: pass --mode or --member.");
+    }
+    const members2 = options.member === void 0 ? existing.members : [.../* @__PURE__ */ new Set([...existing.members, ...options.member])];
+    setVirtualModel(paths, name, { mode: options.mode ?? existing.mode, members: members2 });
+    console.log(`Updated virtual model "${name}" (${options.mode ?? existing.mode}): ${members2.join(", ")}`);
+  });
+  withExamples(
+    modelsCommand.command("remove <name>").description("Remove a virtual model definition.").option("--yes", "Remove without asking for confirmation.").option("--json", "Print the result as JSON."),
+    ["agent-shim model remove fast --yes"]
+  ).action(async (name, options) => {
+    await confirmRemoval(deps, options.yes, `virtual model "${name}"`);
+    removeVirtualModel(paths, name);
+    reportMutation(options.json, { action: "removed", kind: "model", name, value: void 0 }, () => {
+      console.log(`Removed virtual model "${name}".`);
+    });
+  });
+  withExamples(
+    modelsCommand.command("tier <tier>").description("Point one Claude tier (fable, opus, sonnet, haiku) at a model ref: a concrete target, an account model, a virtual model, or a family.").option("--ref <ref>", "The model ref the tier points at. Omit with --clear to reset the tier to its per-provider behaviour.").option("--clear", "Reset the tier to its per-provider behaviour."),
+    ["agent-shim model tier opus --ref fast", "agent-shim model tier opus --clear"]
+  ).action((tier, options) => {
+    const which = asTier(tier);
+    if (options.clear === true) {
+      setTier(paths, which, void 0);
+      console.log(`Tier ${which} reset to its per-provider behaviour.`);
+      return;
+    }
+    if (options.ref === void 0) {
+      throw new UsageError("Pass --ref <ref>, or --clear to reset the tier.");
+    }
+    setTier(paths, which, options.ref);
+    console.log(`Tier ${which} points at ${options.ref}.`);
+  });
+  withExamples(
+    modelsCommand.command("price <ref>").description("Set a model ref's prices, in USD per million tokens, for the cheapest mode.").option("--input <usd>", "The input price per million tokens.", (value2) => asPrice(value2)).option("--output <usd>", "The output price per million tokens.", (value2) => asPrice(value2)).option("--clear", "Remove the ref's prices instead."),
+    ["agent-shim model price z/glm-5.3 --input 0.6 --output 2.2"]
+  ).action((ref, options) => {
+    if (options.clear !== true && (options.input === void 0 || options.output === void 0)) {
+      throw new UsageError("Pass both --input and --output, or --clear to remove the ref's prices.");
+    }
+    setPrice(paths, ref, options.clear === true ? void 0 : { input: options.input ?? 0, output: options.output ?? 0 });
+    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."),
+    ["agent-shim model list"]
+  ).action((options) => {
+    const found = readModels(paths);
+    if (options.json === true) {
+      printJson(found ?? null);
+      return;
+    }
+    if (found === void 0) {
+      console.log("No models block is configured.");
+      return;
+    }
+    for (const [name, model] of Object.entries(found.virtual ?? {})) {
+      console.log(`${name} (${model.mode}): ${model.members.join(", ")}`);
+    }
+    for (const [tier, ref] of Object.entries(found.tiers ?? {})) {
+      console.log(`tier ${tier} -> ${ref}`);
+    }
+    if (found.hide !== void 0) {
+      console.log(`hidden: ${found.hide.join(", ")}`);
+    }
+    if (found.show !== void 0) {
+      console.log(`visible only: ${found.show.join(", ")}`);
+    }
+  });
+}
+function asMode(value2) {
+  const mode = SELECTION_MODES.find((candidate) => candidate === value2);
+  if (mode === void 0) {
+    throw new UsageError(`Unknown mode "${value2}". Known modes: ${SELECTION_MODES.join(", ")}.`);
+  }
+  return mode;
+}
+function asPrice(value2) {
+  const parsed = Number(value2);
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    throw new UsageError(`"${value2}" is not a price: pass a positive number of US dollars.`);
+  }
+  return parsed;
+}
+function asTier(value2) {
+  const tier = CLAUDE_TIERS.find((candidate) => candidate === value2);
+  if (tier === void 0) {
+    throw new UsageError(`Unknown tier "${value2}". Known tiers: ${CLAUDE_TIERS.join(", ")}.`);
+  }
+  return tier;
 }
 
 // src/directoryRules.ts