agent-shim 11.31.1 → 11.33.0

package/dist/cli.cjs

@@ -26987,7 +26987,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, 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";
@@ -27216,13 +27216,54 @@ var init_schema = __esm({
       antigravity: AntigravityProviderConfigSchema.optional()
     });
     ProviderSchema = external_exports.discriminatedUnion("kind", [HttpProviderSchema, CodexProviderSchema, AntigravityProviderSchema]);
+    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 +27374,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 +31875,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 +31964,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 +32583,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 +32622,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 +32687,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 +32712,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 +34432,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "agent-shim",
-      version: "11.31.1",
+      version: "11.33.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>",
@@ -63767,6 +63876,158 @@ var init_launchReport = __esm({
   }
 });
 
+// src/selection/engine.ts
+function compareMaybe(left, right, preferHigh) {
+  if (left === void 0 && right === void 0) {
+    return 0;
+  }
+  if (left === void 0) {
+    return 1;
+  }
+  if (right === void 0) {
+    return -1;
+  }
+  return preferHigh ? right - left : left - right;
+}
+function by(comparator, candidates) {
+  return [...candidates].sort((left, right) => comparator(left, right) || left.order - right.order || (left.ref < right.ref ? -1 : left.ref > right.ref ? 1 : 0));
+}
+function selectOrdered(candidates) {
+  const reasons = candidates.map((candidate) => `${candidate.ref}${availability(candidate)}`);
+  const unspent = candidates.filter((candidate) => candidate.available);
+  const current = unspent.find((candidate) => candidate.isCurrent);
+  if (current !== void 0) {
+    return { ref: current.ref, reasons: [...reasons, `${current.ref} is the model this session is already on and still has quota`] };
+  }
+  const first = by((left, right) => left.order - right.order, candidates)[0];
+  if (first?.available === true) {
+    return { ref: first.ref, reasons: [...reasons, `${first.ref} is the first member with quota`] };
+  }
+  const byPressure = by((left, right) => compareMaybe(left.pressure, right.pressure, true), unspent);
+  const top = byPressure[0];
+  if (top !== void 0) {
+    return { ref: top.ref, reasons: [...reasons, `${top.ref} carries the most allowance its reset would waste`] };
+  }
+  const byReset = by((left, right) => compareMaybe(left.hoursToReset, right.hoursToReset, false), candidates);
+  return { ref: byReset[0]?.ref, reasons: [...reasons, "every member is spent; serving from the one whose window lifts soonest"] };
+}
+function selectRanked(candidates, comparator, what, why) {
+  const ordered = selectOrdered(candidates);
+  const available = candidates.filter((candidate) => candidate.available);
+  if (available.length === 0) {
+    return ordered;
+  }
+  const ranked = by(comparator, available);
+  const best = ranked[0];
+  if (best === void 0) {
+    return ordered;
+  }
+  const current = available.find((candidate) => candidate.isCurrent);
+  const chosen = current !== void 0 && (comparator(current, best) === 0 || best.isCurrent) ? current : best;
+  if (chosen.isCurrent || current === void 0) {
+    return { ref: chosen.ref, reasons: [...ordered.reasons, `${chosen.ref} ${what}`] };
+  }
+  return { ref: best.ref, reasons: [...ordered.reasons, `${best.ref} ${what}; the switch from the current member is worth re-sending the conversation because ${why}`] };
+}
+function selectMember(mode, candidates, options = {}) {
+  const plain = candidates.map((entry) => entry.candidate);
+  switch (mode) {
+    case "ordered":
+      return selectOrdered(plain);
+    case "most-allowance":
+      return selectRanked(plain, (left, right) => compareMaybe(left.remainingAllowance, right.remainingAllowance, true), "holds the most remaining allowance", "its allowance is the largest");
+    case "soonest-reset":
+      return selectRanked(plain, (left, right) => compareMaybe(left.hoursToReset, right.hoursToReset, false), "resets soonest, so its allowance is the most use-it-or-lose-it", "its reset is the soonest");
+    case "lowest-latency":
+      return selectRanked(plain, (left, right) => compareMaybe(left.latencyMs, right.latencyMs, false), "has answered fastest of late", "its latency is the lowest observed");
+    case "highest-success":
+      return selectRanked(plain, (left, right) => compareMaybe(left.successRate, right.successRate, true), "has succeeded most reliably of late", "its success rate is the highest observed");
+    case "cheapest":
+      return selectRanked(plain, (left, right) => compareMaybe(left.pricePerMTok, right.pricePerMTok, false), "is the cheapest for the tokens this session sends", "its blended price is the lowest");
+    case "spread": {
+      const ordered = selectOrdered(plain);
+      const available = plain.filter((candidate) => candidate.available);
+      if (available.length === 0) {
+        return ordered;
+      }
+      const rotation = options.rotation ?? 0;
+      const orderedByList = by((left, right) => left.order - right.order, available);
+      const chosen = orderedByList[rotation % orderedByList.length];
+      return chosen === void 0 ? ordered : { ref: chosen.ref, reasons: [...ordered.reasons, `${chosen.ref} is turn ${String(rotation % orderedByList.length + 1)} of the spread across the members with quota`] };
+    }
+    case "adaptive":
+      return selectAdaptive(candidates, options.needs);
+  }
+  return selectOrdered(plain);
+}
+function selectAdaptive(candidates, needs) {
+  const plain = candidates.map((entry) => entry.candidate);
+  const ruledOut = candidates.map((entry) => {
+    const { candidate, capabilities } = entry;
+    if (needs?.hasImage === true && !capabilities.vision) {
+      return `${candidate.ref} does not accept images`;
+    }
+    if (needs?.hasTools === true && !capabilities.tools) {
+      return `${candidate.ref} does not accept tools`;
+    }
+    if (needs?.thinking === true && !capabilities.thinking) {
+      return `${candidate.ref} does not think`;
+    }
+    if (candidate.available && !candidate.feasible) {
+      return `${candidate.ref} would run dry before its window resets`;
+    }
+    if (candidate.successRate !== void 0 && candidate.successRate < ADAPTIVE_HEALTH_FLOOR) {
+      return `${candidate.ref} has been failing`;
+    }
+    return void 0;
+  }).filter((line) => line !== void 0);
+  const standing = candidates.filter((entry) => {
+    const { candidate, capabilities } = entry;
+    if (!candidate.available) {
+      return false;
+    }
+    if (needs?.hasImage === true && !capabilities.vision) {
+      return false;
+    }
+    if (needs?.hasTools === true && !capabilities.tools) {
+      return false;
+    }
+    if (needs?.thinking === true && !capabilities.thinking) {
+      return false;
+    }
+    if (!candidate.feasible) {
+      return false;
+    }
+    return !(candidate.successRate !== void 0 && candidate.successRate < ADAPTIVE_HEALTH_FLOOR);
+  });
+  const reasons = [...ruledOut];
+  if (standing.length === 0) {
+    const fallback = selectOrdered(plain);
+    return { ref: fallback.ref, reasons: [...reasons, "nothing stands: serving by order"] };
+  }
+  const current = standing.find((entry) => entry.candidate.isCurrent);
+  if (current !== void 0) {
+    return { ref: current.candidate.ref, reasons: [...reasons, `${current.candidate.ref} stands and is the model this session is already on, so the conversation is not re-sent`] };
+  }
+  const ranked = by(
+    (left, right) => compareMaybe(left.pressure, right.pressure, true) || compareMaybe(left.hoursToReset, right.hoursToReset, false) || compareMaybe(left.successRate, right.successRate, true),
+    standing.map((entry) => entry.candidate)
+  );
+  const best = ranked[0];
+  if (best === void 0) {
+    return { ref: void 0, reasons };
+  }
+  return { ref: best.ref, reasons: [...reasons, `${best.ref} stands and carries the most allowance its reset would waste`] };
+}
+var ADAPTIVE_HEALTH_FLOOR, availability;
+var init_engine = __esm({
+  "src/selection/engine.ts"() {
+    "use strict";
+    ADAPTIVE_HEALTH_FLOOR = 0.5;
+    availability = (candidate) => candidate.available ? "" : "quota spent";
+  }
+});
+
 // src/antigravity/cloudUpstream.ts
 function isCcpaEndpoint(endpoint) {
   return endpoint.includes("cloudcode-pa.googleapis.com");
@@ -64309,32 +64570,24 @@ function chooseCandidate(candidates, routing) {
   if (routing === void 0 || candidates.length === 1) {
     return first;
   }
-  if (routing.previous !== void 0 && candidates.includes(routing.previous) && antigravityQuotaExhaustion(routing.quota, routing.previous, routing.nowMs) === void 0) {
-    return routing.previous;
-  }
-  const unspent = candidates.filter((model) => antigravityQuotaExhaustion(routing.quota, model, routing.nowMs) === void 0);
-  if (unspent[0] === first) {
-    return first;
-  }
-  const neutral = 1;
-  let best;
-  for (const model of unspent) {
-    const pressure = antigravityQuotaPressure(routing.quota, model) ?? neutral;
-    if (best === void 0 || pressure > best.pressure) {
-      best = { model, pressure };
-    }
-  }
-  if (best !== void 0) {
-    return best.model;
-  }
-  let soonest;
-  for (const model of candidates) {
-    const exhaustion = antigravityQuotaExhaustion(routing.quota, model, routing.nowMs);
-    if (exhaustion !== void 0 && (soonest === void 0 || exhaustion.resetSec < soonest.resetSec)) {
-      soonest = { model, resetSec: exhaustion.resetSec };
-    }
-  }
-  return soonest?.model ?? first;
+  const exhaustionOf = (model) => antigravityQuotaExhaustion(routing.quota, model, routing.nowMs);
+  const evaluated = candidates.map((model, index) => {
+    const exhaustion = exhaustionOf(model);
+    return {
+      candidate: {
+        ref: model,
+        order: index,
+        available: exhaustion === void 0,
+        // A quota the map does not measure competes at the neutral pressure the old in-place ranking gave it, not as an unknown that always loses.
+        pressure: antigravityQuotaPressure(routing.quota, model) ?? NEUTRAL_PRESSURE,
+        hoursToReset: exhaustion === void 0 ? void 0 : exhaustion.resetSec / SECONDS_PER_HOUR2,
+        feasible: true,
+        isCurrent: routing.previous === model
+      },
+      capabilities: { vision: true, tools: true, thinking: true }
+    };
+  });
+  return selectMember("ordered", evaluated).ref ?? first;
 }
 function mapEffort(request7, config2) {
   const requested = request7.output_config?.effort;
@@ -64526,15 +64779,18 @@ function translateRequest(request7, config2, routing) {
     toolNames
   };
 }
-var import_node_crypto16, AUTO_ALIAS, CONTEXT_MARKER_1M, BACKEND_FAMILY_PREFIXES, BACKEND_CLAUDE_NAME, EFFORT_TO_BUDGET, BILLING_HEADER_LINE, ANTIGRAVITY_TOOL_NAME_LIMIT, TOOL_NAME_HASH_CHARS, NON_TEXT_TOOL_RESULT, EMPTY_SCHEMA, EFFORT_SUFFIXES;
+var import_node_crypto16, SECONDS_PER_HOUR2, NEUTRAL_PRESSURE, AUTO_ALIAS, CONTEXT_MARKER_1M, BACKEND_FAMILY_PREFIXES, BACKEND_CLAUDE_NAME, EFFORT_TO_BUDGET, BILLING_HEADER_LINE, ANTIGRAVITY_TOOL_NAME_LIMIT, TOOL_NAME_HASH_CHARS, NON_TEXT_TOOL_RESULT, EMPTY_SCHEMA, EFFORT_SUFFIXES;
 var init_translate = __esm({
   "src/antigravity/translate.ts"() {
     "use strict";
     import_node_crypto16 = require("node:crypto");
+    init_engine();
     init_quota();
     init_signatures();
     init_schema();
     init_anthropic();
+    SECONDS_PER_HOUR2 = 3600;
+    NEUTRAL_PRESSURE = 1;
     AUTO_ALIAS = "auto";
     CONTEXT_MARKER_1M = "[1m]";
     BACKEND_FAMILY_PREFIXES = ["gemini-", "antigravity-", "gpt-oss-"];
@@ -64812,7 +65068,7 @@ async function fetchCatalogue(params) {
   }
   throw new CatalogueFetchError(`no catalogue from ${outcomes.join("; ")}`);
 }
-var import_node_path42, import_picomatch3, DEFAULT_CANDIDATE_URLS, MS_PER_SECOND8, SECONDS_PER_HOUR2, HOURS_PER_DAY4, MS_PER_HOUR3, HOURS_BETWEEN_RETRIES, HTTP_OK, HTTP_MULTIPLE_CHOICES, CATALOGUE_MAX_AGE_MS, CATALOGUE_RETRY_MS, CATALOGUE_REQUEST_SECONDS, CATALOGUE_REQUEST_TIMEOUT_MS, CATALOGUE_REFRESH_TIMEOUT_MS, CatalogueModelSchema, CatalogueCacheSchema, CatalogueFetchError;
+var import_node_path42, import_picomatch3, DEFAULT_CANDIDATE_URLS, MS_PER_SECOND8, SECONDS_PER_HOUR3, HOURS_PER_DAY4, MS_PER_HOUR3, HOURS_BETWEEN_RETRIES, HTTP_OK, HTTP_MULTIPLE_CHOICES, CATALOGUE_MAX_AGE_MS, CATALOGUE_RETRY_MS, CATALOGUE_REQUEST_SECONDS, CATALOGUE_REQUEST_TIMEOUT_MS, CATALOGUE_REFRESH_TIMEOUT_MS, CatalogueModelSchema, CatalogueCacheSchema, CatalogueFetchError;
 var init_providerCatalogue = __esm({
   "src/providerCatalogue.ts"() {
     "use strict";
@@ -64821,9 +65077,9 @@ var init_providerCatalogue = __esm({
     init_zod();
     DEFAULT_CANDIDATE_URLS = 2;
     MS_PER_SECOND8 = 1e3;
-    SECONDS_PER_HOUR2 = 3600;
+    SECONDS_PER_HOUR3 = 3600;
     HOURS_PER_DAY4 = 24;
-    MS_PER_HOUR3 = SECONDS_PER_HOUR2 * MS_PER_SECOND8;
+    MS_PER_HOUR3 = SECONDS_PER_HOUR3 * MS_PER_SECOND8;
     HOURS_BETWEEN_RETRIES = 1;
     HTTP_OK = 200;
     HTTP_MULTIPLE_CHOICES = 300;
@@ -65823,7 +66079,7 @@ function quotaFreshnessMs(quota) {
   const lengths = quota.windows.flatMap((window) => window.periodMs === void 0 ? [] : [window.periodMs]);
   return lengths.length === 0 ? Number.POSITIVE_INFINITY : Math.min(...lengths) / PERCENT3;
 }
-var ProviderQuotaError, MS_PER_SECOND9, SECONDS_PER_HOUR3, HOURS_PER_DAY5, DAYS_PER_MONTH, PERCENT3, HTTP_OK2, ZAI_SOURCE, ZAI_HOST, ZAI_QUOTA_URL, ZAI_UNIT_HOURS, ZAI_UNIT_MONTHS, ZAI_UNIT_MS, ZAI_MEASURES, ZaiLimitSchema, ZaiResponseSchema, zaiQuotaAdapter, OPENROUTER_SOURCE, OPENROUTER_HOST, OPENROUTER_KEY_URL, OPENROUTER_CREDITS_URL, HTTP_FORBIDDEN, MS_PER_DAY2, OpenRouterKeySchema, OpenRouterCreditsSchema, openRouterQuotaAdapter, ANTIGRAVITY_SOURCE, ANTIGRAVITY_HOST, ANTIGRAVITY_QUOTA_URL, ANTIGRAVITY_USER_URL, GOOGLE_TOKENINFO_URL, FIVE_HOURS2, DAYS_PER_WEEK2, FIVE_HOURS_MS, WEEK_MS, AntigravityBucketSchema, AntigravitySummarySchema, GoogleTokenInfoSchema, AntigravityUserSchema, ANTIGRAVITY_WINDOW_MS, antigravityQuotaAdapter, PROVIDER_QUOTA_ADAPTERS;
+var ProviderQuotaError, MS_PER_SECOND9, SECONDS_PER_HOUR4, HOURS_PER_DAY5, DAYS_PER_MONTH, PERCENT3, HTTP_OK2, ZAI_SOURCE, ZAI_HOST, ZAI_QUOTA_URL, ZAI_UNIT_HOURS, ZAI_UNIT_MONTHS, ZAI_UNIT_MS, ZAI_MEASURES, ZaiLimitSchema, ZaiResponseSchema, zaiQuotaAdapter, OPENROUTER_SOURCE, OPENROUTER_HOST, OPENROUTER_KEY_URL, OPENROUTER_CREDITS_URL, HTTP_FORBIDDEN, MS_PER_DAY2, OpenRouterKeySchema, OpenRouterCreditsSchema, openRouterQuotaAdapter, ANTIGRAVITY_SOURCE, ANTIGRAVITY_HOST, ANTIGRAVITY_QUOTA_URL, ANTIGRAVITY_USER_URL, GOOGLE_TOKENINFO_URL, FIVE_HOURS2, DAYS_PER_WEEK2, FIVE_HOURS_MS, WEEK_MS, AntigravityBucketSchema, AntigravitySummarySchema, GoogleTokenInfoSchema, AntigravityUserSchema, ANTIGRAVITY_WINDOW_MS, antigravityQuotaAdapter, PROVIDER_QUOTA_ADAPTERS;
 var init_providerQuota = __esm({
   "src/usage/providerQuota.ts"() {
     "use strict";
@@ -65837,7 +66093,7 @@ var init_providerQuota = __esm({
       }
     };
     MS_PER_SECOND9 = 1e3;
-    SECONDS_PER_HOUR3 = 3600;
+    SECONDS_PER_HOUR4 = 3600;
     HOURS_PER_DAY5 = 24;
     DAYS_PER_MONTH = 30;
     PERCENT3 = 100;
@@ -65848,8 +66104,8 @@ var init_providerQuota = __esm({
     ZAI_UNIT_HOURS = 3;
     ZAI_UNIT_MONTHS = 5;
     ZAI_UNIT_MS = /* @__PURE__ */ new Map([
-      [ZAI_UNIT_HOURS, SECONDS_PER_HOUR3 * MS_PER_SECOND9],
-      [ZAI_UNIT_MONTHS, DAYS_PER_MONTH * HOURS_PER_DAY5 * SECONDS_PER_HOUR3 * MS_PER_SECOND9]
+      [ZAI_UNIT_HOURS, SECONDS_PER_HOUR4 * MS_PER_SECOND9],
+      [ZAI_UNIT_MONTHS, DAYS_PER_MONTH * HOURS_PER_DAY5 * SECONDS_PER_HOUR4 * MS_PER_SECOND9]
     ]);
     ZAI_MEASURES = { TOKENS_LIMIT: "tokens", TIME_LIMIT: "tool-calls" };
     ZaiLimitSchema = external_exports.object({
@@ -65901,7 +66157,7 @@ var init_providerQuota = __esm({
     OPENROUTER_KEY_URL = `https://${OPENROUTER_HOST}/api/v1/key`;
     OPENROUTER_CREDITS_URL = `https://${OPENROUTER_HOST}/api/v1/credits`;
     HTTP_FORBIDDEN = 403;
-    MS_PER_DAY2 = HOURS_PER_DAY5 * SECONDS_PER_HOUR3 * MS_PER_SECOND9;
+    MS_PER_DAY2 = HOURS_PER_DAY5 * SECONDS_PER_HOUR4 * MS_PER_SECOND9;
     OpenRouterKeySchema = external_exports.object({
       data: external_exports.object({
         limit: external_exports.number().nonnegative().nullable(),
@@ -65949,8 +66205,8 @@ var init_providerQuota = __esm({
     GOOGLE_TOKENINFO_URL = "https://oauth2.googleapis.com/tokeninfo";
     FIVE_HOURS2 = 5;
     DAYS_PER_WEEK2 = 7;
-    FIVE_HOURS_MS = FIVE_HOURS2 * SECONDS_PER_HOUR3 * MS_PER_SECOND9;
-    WEEK_MS = DAYS_PER_WEEK2 * HOURS_PER_DAY5 * SECONDS_PER_HOUR3 * MS_PER_SECOND9;
+    FIVE_HOURS_MS = FIVE_HOURS2 * SECONDS_PER_HOUR4 * MS_PER_SECOND9;
+    WEEK_MS = DAYS_PER_WEEK2 * HOURS_PER_DAY5 * SECONDS_PER_HOUR4 * MS_PER_SECOND9;
     AntigravityBucketSchema = external_exports.object({
       bucketId: external_exports.string(),
       remainingFraction: external_exports.number().optional(),
@@ -67064,7 +67320,7 @@ function Lp(e14) {
 function my(e14) {
   return e14.replace(/[\u200c-\u200f\u202a-\u202e\u206a-\u206f\ufeff]/g, "").toUpperCase().toLowerCase();
 }
-function by(e14, t10) {
+function by2(e14, t10) {
   if (Qo(e14)) return true;
   if (Yn(e14)) {
     let n10 = hc(e14);
@@ -67672,7 +67928,7 @@ function ri(e14) {
   return po(e14);
 }
 function Vp(e14, t10) {
-  return t10 !== void 0 && t10.some((n10) => po(n10) && !by(e14, n10) && (Xy(e14, n10) || Yn(e14)));
+  return t10 !== void 0 && t10.some((n10) => po(n10) && !by2(e14, n10) && (Xy(e14, n10) || Yn(e14)));
 }
 function Ck(e14, t10) {
   return t10 !== void 0 && t10.some((n10) => po(n10) && Xy(n10, e14));
@@ -67682,7 +67938,7 @@ function Xy(e14, t10) {
   return r10 === o || r10.startsWith(o === "/" ? o : o + "/");
 }
 function Zp(e14, t10) {
-  return t10 === void 0 || t10.every((n10) => by(e14, n10));
+  return t10 === void 0 || t10.every((n10) => by2(e14, n10));
 }
 function vk(e14, t10) {
   return t10 === void 0 || t10.every((n10) => zO(e14, n10));
@@ -118864,6 +119120,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();
@@ -119050,7 +119462,8 @@ var DOCTOR_SECTIONS = [
   "categories-local",
   "active-identity",
   "headroom",
-  "frontdoor"
+  "frontdoor",
+  "models"
 ];
 function refinePathShadow(status, ownExecutablePath, realpath) {
   if (status.status !== "shadowed") {
@@ -119202,6 +119615,9 @@ function pushLegacyName(push, params) {
     );
   }
 }
+function parsedModelsOf(paths) {
+  return readGlobalConfig(paths)?.models;
+}
 function runDoctor(params) {
   const findings = [];
   const push = (section, severity, message, subject) => {
@@ -119403,6 +119819,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 {
@@ -119497,6 +119924,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",
@@ -119629,6 +120057,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,
@@ -133875,6 +134304,67 @@ function createRealQuotaRefresher(params) {
 
 // src/frontdoor/commands.ts
 init_store2();
+
+// src/selection/targetStore.ts
+init_read();
+
+// src/selection/signals.ts
+function targetOf(record2) {
+  return record2.model === void 0 ? void 0 : `${record2.provider}/${record2.model}`;
+}
+function median(values) {
+  if (values.length === 0) {
+    return void 0;
+  }
+  const sorted = [...values].sort((left, right) => left - right);
+  const middle = Math.floor(sorted.length / 2);
+  const above = sorted[middle];
+  const below = sorted[middle - 1];
+  return sorted.length % 2 === 0 && above !== void 0 && below !== void 0 ? (above + below) / 2 : sorted[middle];
+}
+var OBSERVATION_WINDOW = 20;
+function observeRecord(observations, record2) {
+  const target = targetOf(record2);
+  if (target === void 0) {
+    return new Map(observations);
+  }
+  const kept = [...observations.get(target) ?? [], record2].slice(-OBSERVATION_WINDOW);
+  return new Map(observations).set(target, kept);
+}
+function observationOf(records) {
+  const completed = records.filter((record2) => record2.outcome === "completed");
+  const latencies = completed.map((record2) => record2.latencyMs);
+  const usage = records.flatMap((record2) => record2.usage === void 0 ? [] : [record2.usage]);
+  const input2 = usage.reduce((sum, entry) => sum + (entry.inputTokens ?? 0), 0);
+  const output2 = usage.reduce((sum, entry) => sum + (entry.outputTokens ?? 0), 0);
+  const cacheRead = usage.reduce((sum, entry) => sum + (entry.cacheReadInputTokens ?? 0), 0);
+  return {
+    latencyMs: median(latencies),
+    successRate: records.length === 0 ? void 0 : completed.length / records.length,
+    tokenMix: input2 + output2 + cacheRead === 0 ? void 0 : { input: input2, output: output2, cacheRead }
+  };
+}
+
+// src/selection/targetStore.ts
+var SEED_LOOKBACK_RECORDS = 500;
+function createTargetObservationStore(fs26, paths) {
+  let observations = /* @__PURE__ */ new Map();
+  const seeded = readUsageLog(fs26, paths.usageLogDir, {}).records.slice(-SEED_LOOKBACK_RECORDS);
+  for (const record2 of seeded) {
+    observations = observeRecord(observations, record2);
+  }
+  return {
+    observe: (record2) => {
+      observations = observeRecord(observations, record2);
+    },
+    observation: (target) => {
+      const records = observations.get(target);
+      return records === void 0 ? void 0 : observationOf(records);
+    }
+  };
+}
+
+// src/frontdoor/commands.ts
 function respawnInvocation(paths) {
   const env = {};
   for (const [name, value2] of Object.entries({ ...process.env, AGENT_SHIM_HOME: paths.root })) {
@@ -134061,7 +134551,11 @@ function realFrontDoorSupervisorPorts(paths) {
   catalogueKeeper.tick();
   setInterval(catalogueKeeper.tick, ANTHROPIC_USAGE_FRESHNESS_MS).unref();
   const headroomDecision = createHeadroomDecision(createRoutingSettingReader(paths));
-  const recordUsage = withQuotaRefresh(usageStore.record, quotaRefresher);
+  const targetObservations = createTargetObservationStore(realFarmFs, paths);
+  const recordUsage = (record2) => {
+    withQuotaRefresh(usageStore.record, quotaRefresher)(record2);
+    targetObservations.observe(record2);
+  };
   const usageMiddleware = createUsageMiddleware({
     // Each finished response also tells the per-session headroom decision when the session's cache was last touched and whether it read from it.
     record: (record2, event) => {
@@ -146610,6 +147104,298 @@ function registerProviderCommand(program2, deps) {
   );
 }
 
+// src/models.ts
+init_commandDeps();
+init_providersStore();
+init_modelPicker();
+init_providerCatalogue();
+init_realPorts();
+init_schema();
+init_cliError();
+
+// src/models/identity.ts
+var NON_IDENTITY_BRACKET_RE = /\[[^\]]*\]/g;
+var DATE_STAMP_RE = /-(?:19|20)\d{2}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\d|3[01])$/;
+var KNOWN_VARIANTS = /* @__PURE__ */ new Set(["high", "medium", "low", "thinking", "xhigh", "max", "highspeed", "sol", "terra", "luna", "mini", "flash-lite", "turbo"]);
+var 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"
+});
+var 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"
+});
+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;
+}
+
+// src/models.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 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);
+    }
+  }
+  const similar = [];
+  for (let outer = 0; outer < models.length; outer += 1) {
+    for (let inner = outer + 1; inner < models.length; inner += 1) {
+      const left = models[outer];
+      const right = models[inner];
+      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))) {
+        similar.push([left, right]);
+      }
+    }
+  }
+  return { same: same.filter((group) => group.length > 1), 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, ["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"]
+  ).action((options) => {
+    const models = providerModels(paths);
+    const { same, similar } = matchModels(models);
+    if (options.json === true) {
+      printJson({ models, same, similar });
+      return;
+    }
+    console.log(`Models of ${String(models.length)} across the defined providers:`);
+    if (same.length === 0 && similar.length === 0) {
+      console.log("  no two names are the same model, and none look alike");
+      return;
+    }
+    for (const group of same) {
+      console.log(`  same: ${group.map((entry) => `${entry.provider}/${entry.model}`).join(" = ")}`);
+    }
+    for (const [left, right] of similar) {
+      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
 init_commandDeps();
 init_cliError();
@@ -147104,6 +147890,7 @@ function buildProgram(deps) {
   registerJobCommand(program2, deps);
   registerHeadlessCommands(program2, deps);
   registerProviderCommand(program2, deps);
+  registerModelsCommand(program2, deps);
   registerRuleCommand(program2, deps);
   registerCredentialCommand(program2, deps, deps.credentialPorts);
   registerCheckCommand(program2, deps);