pullfrog 0.1.76 → 0.1.77

package/dist/cli.mjs

@@ -123000,7 +123000,7 @@ var import_picocolors = __toESM(require_picocolors(), 1);
 // package.json
 var package_default = {
   name: "pullfrog",
-  version: "0.1.76",
+  version: "0.1.77",
   cliContractVersion: "1",
   type: "module",
   bin: {
@@ -126072,6 +126072,71 @@ var AUTO_TIER_TARGET = {
 function isAutoTier(slug2) {
   return slug2 === AUTO_EFFICIENT || slug2 === AUTO_INTELLIGENT;
 }
+var PROVIDER_LADDERS = {
+  anthropic: {
+    minimal: "anthropic/claude-haiku",
+    light: "anthropic/claude-sonnet",
+    standard: "anthropic/claude-opus",
+    deep: "anthropic/claude-opus"
+  },
+  openai: {
+    minimal: "openai/gpt-luna",
+    light: "openai/gpt-terra",
+    standard: "openai/gpt-sol",
+    deep: "openai/gpt-astra"
+  },
+  google: {
+    minimal: "google/gemini-flash",
+    light: "google/gemini-flash",
+    standard: "google/gemini-pro",
+    deep: "google/gemini-pro"
+  },
+  deepseek: {
+    minimal: "deepseek/deepseek-flash",
+    light: "deepseek/deepseek-flash",
+    standard: "deepseek/deepseek-pro",
+    deep: "deepseek/deepseek-pro"
+  },
+  xai: {
+    minimal: "xai/grok-fast",
+    light: "xai/grok-fast",
+    standard: "xai/grok",
+    deep: "xai/grok"
+  },
+  moonshotai: {
+    minimal: "moonshotai/kimi-k2",
+    light: "moonshotai/kimi-k2",
+    standard: "moonshotai/kimi-k3",
+    deep: "moonshotai/kimi-k3"
+  },
+  openrouter: {
+    minimal: "openrouter/deepseek-flash",
+    light: "openrouter/gpt-luna",
+    standard: "openrouter/gpt-sol",
+    deep: "openrouter/claude-opus"
+  },
+  opencode: {
+    minimal: "opencode/gpt-luna",
+    light: "opencode/gpt-luna",
+    standard: "opencode/gpt-sol",
+    deep: "opencode/claude-opus"
+  }
+};
+var ROUTER_LADDER = {
+  minimal: "deepseek/deepseek-flash",
+  light: "openai/gpt-luna",
+  standard: "openai/gpt-sol",
+  deep: "anthropic/claude-opus"
+};
+var AUTO_PREFIX = "auto/";
+function autoLadder(slug2) {
+  if (!slug2 || !slug2.startsWith(AUTO_PREFIX) || isAutoTier(slug2)) return void 0;
+  const target = slug2.slice(AUTO_PREFIX.length);
+  return target === "router" ? ROUTER_LADDER : PROVIDER_LADDERS[target];
+}
+var ROUTED_PROVIDERS = Object.keys(
+  PROVIDER_LADDERS
+).map((key) => ({ key, displayName: providers[key].displayName }));
 function isCardGatedModel(slug2) {
   return resolveOpenRouterModel(slug2) !== void 0;
 }
@@ -126080,7 +126145,7 @@ function resolveModelSlug(slug2) {
 }
 var MAX_FALLBACK_DEPTH = 10;
 function resolveDisplayAlias(slug2) {
-  let current = isAutoTier(slug2) ? AUTO_TIER_TARGET[slug2] : slug2;
+  let current = isAutoTier(slug2) ? AUTO_TIER_TARGET[slug2] : autoLadder(slug2)?.standard ?? slug2;
   const visited = /* @__PURE__ */ new Set();
   for (let i2 = 0; i2 < MAX_FALLBACK_DEPTH; i2++) {
     if (visited.has(current)) return void 0;
@@ -126115,6 +126180,11 @@ if (!defaultProxyAlias?.openRouterResolve) {
 }
 var DEFAULT_PROXY_MODEL = defaultProxyAlias.openRouterResolve;
 var defaultProxyDisplayName = defaultProxyAlias.displayName;
+for (const [name, ladder] of Object.entries({ ...PROVIDER_LADDERS, router: ROUTER_LADDER })) {
+  for (const slug2 of Object.values(ladder)) {
+    if (!resolveDisplayAlias(slug2)) throw new Error(`${name} ladder names unknown alias ${slug2}`);
+  }
+}
 var OSS_MODEL_ALLOWLIST = [
   "deepseek/deepseek-flash",
   "deepseek/deepseek-pro",
@@ -216616,6 +216686,15 @@ var JsonPayload = type({
   "type?": "string | undefined",
   "model?": "string | undefined",
   "modelExplicit?": "boolean | undefined",
+  // optional so a payload from a pre-router server build still parses against a
+  // newer action across a rolling deploy.
+  "routing?": type({
+    tier: "'minimal' | 'light' | 'standard' | 'deep'",
+    stakes: "number",
+    workload: "number",
+    source: "'scorer' | 'heuristic' | 'fixed'",
+    rationale: "string"
+  }).or("undefined"),
   "effort?": "number | string | undefined",
   "debug?": "boolean | undefined",
   prompt: "string",
@@ -216797,6 +216876,7 @@ function resolvePayload(resolvedPromptInput, repoSettings) {
     // explicit only when the model came from a per-run override flag (carried on
     // the JSON payload). a GHA `model` input or the repo default is not explicit.
     modelExplicit: jsonPayload?.modelExplicit ?? false,
+    routing: jsonPayload?.routing,
     effort,
     debug: debug4 || void 0,
     prompt,
@@ -217483,9 +217563,12 @@ async function fetchRunContext(params) {
     if (params.oidcToken) {
       headers["X-GitHub-OIDC-Token"] = params.oidcToken;
     }
-    const query = params.runType ? `?type=${encodeURIComponent(params.runType)}` : "";
+    const query = new URLSearchParams();
+    if (params.runType) query.set("type", params.runType);
+    if (params.routedTier) query.set("tier", params.routedTier);
+    const search2 = query.toString();
     const response = await apiFetch({
-      path: `/api/repo/${params.repoContext.owner}/${params.repoContext.name}/run-context${query}`,
+      path: `/api/repo/${params.repoContext.owner}/${params.repoContext.name}/run-context${search2 ? `?${search2}` : ""}`,
       headers,
       signal: controller.signal
     });
@@ -217552,7 +217635,13 @@ async function resolveRunContextData(params) {
       retries: [100, 500],
       bail: (error109) => !isTransientOctokitError(error109)
     })(),
-    fetchRunContext({ token: params.token, repoContext, oidcToken, runType: params.runType })
+    fetchRunContext({
+      token: params.token,
+      repoContext,
+      oidcToken,
+      runType: params.runType,
+      routedTier: params.routedTier
+    })
   ]);
   return {
     repo: {
@@ -218460,6 +218549,12 @@ function logRunStartup(ctx) {
   log2.info(
     `\xBB effort:  ${resolveEffortForLog({ payload: ctx.payload, resolvedModel: ctx.resolvedModel })}`
   );
+  const routing = ctx.payload.routing;
+  if (routing) {
+    log2.info(
+      `\xBB routed:  ${routing.tier} (${routing.source}: stakes ${routing.stakes}, workload ${routing.workload}) \u2014 ${routing.rationale}`
+    );
+  }
   log2.info(
     `\xBB agent:   ${resolveAgentForLog({ agentName: ctx.agentName, resolvedModel: ctx.resolvedModel })}`
   );
@@ -218654,7 +218749,8 @@ async function main() {
     const runContext = await resolveRunContextData({
       octokit: initialOctokit,
       token: jobToken,
-      runType: typeof resolvedPromptInput === "string" ? void 0 : resolvedPromptInput.type
+      runType: typeof resolvedPromptInput === "string" ? void 0 : resolvedPromptInput.type,
+      routedTier: typeof resolvedPromptInput === "string" ? void 0 : resolvedPromptInput.routing?.tier
     });
     timer.checkpoint("runContextData");
     const payload = resolvePayload(resolvedPromptInput, runContext.repoSettings);
@@ -219775,7 +219871,7 @@ function resolveTarget2(repo) {
   return { owner: match3[1], repo: match3[2] };
 }
 function cliVersion() {
-  const parts = /^(\d+)\.(\d+)\.(\d+)$/.exec("0.1.76");
+  const parts = /^(\d+)\.(\d+)\.(\d+)$/.exec("0.1.77");
   if (!parts) return "0.0.0";
   return `${Number(parts[1])}.${Number(parts[2])}.${Number(parts[3])}`;
 }
@@ -219942,7 +220038,7 @@ async function runCli8(input2) {
 }
 
 // cli.ts
-var VERSION10 = "0.1.76";
+var VERSION10 = "0.1.77";
 var bin = basename2(process.argv[1] || "");
 var PROG = bin === "pf" || bin === "pullfrog" ? bin : "pullfrog";
 var rawArgs = process.argv.slice(2);

package/dist/external.d.ts

@@ -4,6 +4,7 @@
  * Other files in action/ re-export from this file for backward compatibility.
  */
 import type { EffortPosition } from "./effort.ts";
+import type { RouterTier } from "./models.ts";
 export declare const pullfrogMcpName = "pullfrog";
 /** @see {@link file://./agents/shared.ts} Agent interface that uses this type */
 export type AgentId = "claude" | "codex" | "opencode";
@@ -51,8 +52,8 @@ export declare function findDanglingPromptToolRefs(params: {
 }): string[];
 export type { EffortPosition } from "./effort.ts";
 export { DEFAULT_EFFORT_POSITION, EFFORT_ALIASES, isEffortPosition, offeredRungs, parseEffortPosition, resolveRung, rungLabel, rungPosition, SUBSIDY_RUNG, } from "./effort.ts";
-export type { AutoTier, ModelAlias, ModelProvider, ProviderConfig } from "./models.ts";
-export { AUTO_EFFICIENT, AUTO_INTELLIGENT, DEFAULT_PROXY_MODEL, defaultAutoTier, getAutoSelectHintModel, getModelEffortLevels, getModelEnvVars, getModelManagedCredentials, getModelProvider, getProviderDisplayName, isAutoTier, isCardGatedModel, isOssAllowedModel, modelAliases, modelHasStoredAuth, OSS_MODEL_ALLOWLIST, OSS_RECOMMENDED_MODEL, ossFundedModelNames, PROVIDER_GATEWAY_URL_ENV, parseModel, providers, resolveAutoTier, resolveCliModel, resolveDisplayAlias, resolveModelRung, resolveModelSlug, resolveOpenRouterModel, } from "./models.ts";
+export type { AutoTier, ModelAlias, ModelProvider, ProviderConfig, RouterTier, } from "./models.ts";
+export { AUTO_EFFICIENT, AUTO_INTELLIGENT, AUTO_ROUTER, autoLadder, autoRoutedSlug, DEFAULT_PROXY_MODEL, defaultAutoTier, getAutoSelectHintModel, getModelEffortLevels, getModelEnvVars, getModelManagedCredentials, getModelProvider, getProviderDisplayName, isAutoRouted, isAutoSlug, isAutoTier, isCardGatedModel, isOssAllowedModel, isRouterTier, ladderRungs, modelAliases, modelHasStoredAuth, OSS_MODEL_ALLOWLIST, OSS_RECOMMENDED_MODEL, ossFundedModelNames, PROVIDER_GATEWAY_URL_ENV, parseModel, providers, ROUTED_PROVIDERS, ROUTER_LADDER, ROUTER_TIERS, resolveAutoTier, resolveCliModel, resolveDisplayAlias, resolveModelRung, resolveModelSlug, resolveOpenRouterModel, resolveRoutedModel, } from "./models.ts";
 export type ToolPermission = "disabled" | "enabled";
 export type ShellPermission = "disabled" | "restricted" | "enabled";
 export type PushPermission = "disabled" | "restricted" | "enabled";
@@ -262,6 +263,21 @@ export interface XrepoConfig {
      */
     unavailable?: string[] | undefined;
 }
+/**
+ * the model router's decision, carried so the runner can log it and forward the
+ * tier to run-context as `?tier=` — the Router proxy mint happens there and
+ * never sees `model` below. see wiki/router.md.
+ */
+export interface PayloadRouting {
+    tier: RouterTier;
+    stakes: number;
+    workload: number;
+    /** who decided: the scorer, the heuristic it falls back to, or the fixed tier a non-review kind of work carries. mirrors the `RouterSource` enum. */
+    source: RouterSource;
+    /** the scorer's own sentence or two on what a reviewer must reconstruct */
+    rationale: string;
+}
+export type RouterSource = "scorer" | "heuristic" | "fixed";
 export interface WriteablePayload {
     "~pullfrog": true;
     /** semantic version of the payload to ensure compatibility */
@@ -283,6 +299,8 @@ export interface WriteablePayload {
      * baseInstructions flag) keeps the soft-fallback safety net. see modelAccess.ts.
      */
     modelExplicit?: boolean | undefined;
+    /** the model router's decision, when it made one; `model` above already reflects it */
+    routing?: PayloadRouting | undefined;
     /** reasoning-effort position on [0,1]; 0 is the model's cheapest rung, 1 its priciest */
     effort?: EffortPosition | undefined;
     /**

package/dist/index.js

@@ -108891,6 +108891,71 @@ var AUTO_TIER_TARGET = {
 function isAutoTier(slug2) {
   return slug2 === AUTO_EFFICIENT || slug2 === AUTO_INTELLIGENT;
 }
+var PROVIDER_LADDERS = {
+  anthropic: {
+    minimal: "anthropic/claude-haiku",
+    light: "anthropic/claude-sonnet",
+    standard: "anthropic/claude-opus",
+    deep: "anthropic/claude-opus"
+  },
+  openai: {
+    minimal: "openai/gpt-luna",
+    light: "openai/gpt-terra",
+    standard: "openai/gpt-sol",
+    deep: "openai/gpt-astra"
+  },
+  google: {
+    minimal: "google/gemini-flash",
+    light: "google/gemini-flash",
+    standard: "google/gemini-pro",
+    deep: "google/gemini-pro"
+  },
+  deepseek: {
+    minimal: "deepseek/deepseek-flash",
+    light: "deepseek/deepseek-flash",
+    standard: "deepseek/deepseek-pro",
+    deep: "deepseek/deepseek-pro"
+  },
+  xai: {
+    minimal: "xai/grok-fast",
+    light: "xai/grok-fast",
+    standard: "xai/grok",
+    deep: "xai/grok"
+  },
+  moonshotai: {
+    minimal: "moonshotai/kimi-k2",
+    light: "moonshotai/kimi-k2",
+    standard: "moonshotai/kimi-k3",
+    deep: "moonshotai/kimi-k3"
+  },
+  openrouter: {
+    minimal: "openrouter/deepseek-flash",
+    light: "openrouter/gpt-luna",
+    standard: "openrouter/gpt-sol",
+    deep: "openrouter/claude-opus"
+  },
+  opencode: {
+    minimal: "opencode/gpt-luna",
+    light: "opencode/gpt-luna",
+    standard: "opencode/gpt-sol",
+    deep: "opencode/claude-opus"
+  }
+};
+var ROUTER_LADDER = {
+  minimal: "deepseek/deepseek-flash",
+  light: "openai/gpt-luna",
+  standard: "openai/gpt-sol",
+  deep: "anthropic/claude-opus"
+};
+var AUTO_PREFIX = "auto/";
+function autoLadder(slug2) {
+  if (!slug2 || !slug2.startsWith(AUTO_PREFIX) || isAutoTier(slug2)) return void 0;
+  const target = slug2.slice(AUTO_PREFIX.length);
+  return target === "router" ? ROUTER_LADDER : PROVIDER_LADDERS[target];
+}
+var ROUTED_PROVIDERS = Object.keys(
+  PROVIDER_LADDERS
+).map((key) => ({ key, displayName: providers[key].displayName }));
 function isCardGatedModel(slug2) {
   return resolveOpenRouterModel(slug2) !== void 0;
 }
@@ -108899,7 +108964,7 @@ function resolveModelSlug(slug2) {
 }
 var MAX_FALLBACK_DEPTH = 10;
 function resolveDisplayAlias(slug2) {
-  let current = isAutoTier(slug2) ? AUTO_TIER_TARGET[slug2] : slug2;
+  let current = isAutoTier(slug2) ? AUTO_TIER_TARGET[slug2] : autoLadder(slug2)?.standard ?? slug2;
   const visited = /* @__PURE__ */ new Set();
   for (let i = 0; i < MAX_FALLBACK_DEPTH; i++) {
     if (visited.has(current)) return void 0;
@@ -108934,6 +108999,11 @@ if (!defaultProxyAlias?.openRouterResolve) {
 }
 var DEFAULT_PROXY_MODEL = defaultProxyAlias.openRouterResolve;
 var defaultProxyDisplayName = defaultProxyAlias.displayName;
+for (const [name, ladder] of Object.entries({ ...PROVIDER_LADDERS, router: ROUTER_LADDER })) {
+  for (const slug2 of Object.values(ladder)) {
+    if (!resolveDisplayAlias(slug2)) throw new Error(`${name} ladder names unknown alias ${slug2}`);
+  }
+}
 var OSS_MODEL_ALLOWLIST = [
   "deepseek/deepseek-flash",
   "deepseek/deepseek-pro",
@@ -109806,7 +109876,7 @@ var import_semver = __toESM(require_semver2(), 1);
 // package.json
 var package_default = {
   name: "pullfrog",
-  version: "0.1.76",
+  version: "0.1.77",
   cliContractVersion: "1",
   type: "module",
   bin: {
@@ -199476,6 +199546,15 @@ var JsonPayload = type({
   "type?": "string | undefined",
   "model?": "string | undefined",
   "modelExplicit?": "boolean | undefined",
+  // optional so a payload from a pre-router server build still parses against a
+  // newer action across a rolling deploy.
+  "routing?": type({
+    tier: "'minimal' | 'light' | 'standard' | 'deep'",
+    stakes: "number",
+    workload: "number",
+    source: "'scorer' | 'heuristic' | 'fixed'",
+    rationale: "string"
+  }).or("undefined"),
   "effort?": "number | string | undefined",
   "debug?": "boolean | undefined",
   prompt: "string",
@@ -199657,6 +199736,7 @@ function resolvePayload(resolvedPromptInput, repoSettings) {
     // explicit only when the model came from a per-run override flag (carried on
     // the JSON payload). a GHA `model` input or the repo default is not explicit.
     modelExplicit: jsonPayload?.modelExplicit ?? false,
+    routing: jsonPayload?.routing,
     effort,
     debug: debug3 || void 0,
     prompt,
@@ -200343,9 +200423,12 @@ async function fetchRunContext(params) {
     if (params.oidcToken) {
       headers["X-GitHub-OIDC-Token"] = params.oidcToken;
     }
-    const query = params.runType ? `?type=${encodeURIComponent(params.runType)}` : "";
+    const query = new URLSearchParams();
+    if (params.runType) query.set("type", params.runType);
+    if (params.routedTier) query.set("tier", params.routedTier);
+    const search2 = query.toString();
     const response = await apiFetch({
-      path: `/api/repo/${params.repoContext.owner}/${params.repoContext.name}/run-context${query}`,
+      path: `/api/repo/${params.repoContext.owner}/${params.repoContext.name}/run-context${search2 ? `?${search2}` : ""}`,
       headers,
       signal: controller.signal
     });
@@ -200412,7 +200495,13 @@ async function resolveRunContextData(params) {
       retries: [100, 500],
       bail: (error62) => !isTransientOctokitError(error62)
     })(),
-    fetchRunContext({ token: params.token, repoContext, oidcToken, runType: params.runType })
+    fetchRunContext({
+      token: params.token,
+      repoContext,
+      oidcToken,
+      runType: params.runType,
+      routedTier: params.routedTier
+    })
   ]);
   return {
     repo: {
@@ -201320,6 +201409,12 @@ function logRunStartup(ctx) {
   log.info(
     `\xBB effort:  ${resolveEffortForLog({ payload: ctx.payload, resolvedModel: ctx.resolvedModel })}`
   );
+  const routing = ctx.payload.routing;
+  if (routing) {
+    log.info(
+      `\xBB routed:  ${routing.tier} (${routing.source}: stakes ${routing.stakes}, workload ${routing.workload}) \u2014 ${routing.rationale}`
+    );
+  }
   log.info(
     `\xBB agent:   ${resolveAgentForLog({ agentName: ctx.agentName, resolvedModel: ctx.resolvedModel })}`
   );
@@ -201514,7 +201609,8 @@ async function main() {
     const runContext = await resolveRunContextData({
       octokit: initialOctokit,
       token: jobToken,
-      runType: typeof resolvedPromptInput === "string" ? void 0 : resolvedPromptInput.type
+      runType: typeof resolvedPromptInput === "string" ? void 0 : resolvedPromptInput.type,
+      routedTier: typeof resolvedPromptInput === "string" ? void 0 : resolvedPromptInput.routing?.tier
     });
     timer.checkpoint("runContextData");
     const payload = resolvePayload(resolvedPromptInput, runContext.repoSettings);

package/dist/internal/index.d.ts

@@ -5,8 +5,8 @@
 export { CLI_CONTRACT_HEADER, CLI_CONTRACT_VERSION, CLI_UPGRADE_MESSAGE } from "../cliContract.ts";
 export type { ConfigField, ConfigScope, ConfigValue } from "../configuration.ts";
 export { configEntrySchema, configFields, configResponseSchema, configValueSchema, } from "../configuration.ts";
-export type { AuthorPermission, AutoTier, EffortPosition, ModelAlias, ModelProvider, Payload, PayloadEvent, ProviderConfig, PushPermission, ShellPermission, ToolPermission, WriteablePayload, XrepoConfig, } from "../external.ts";
-export { AUTO_EFFICIENT, AUTO_INTELLIGENT, DEFAULT_EFFORT_POSITION, DEFAULT_PROXY_MODEL, defaultAutoTier, EFFORT_ALIASES, getAutoSelectHintModel, getModelEffortLevels, getModelEnvVars, getModelManagedCredentials, getModelProvider, getProviderDisplayName, isAutoTier, isCardGatedModel, isEffortPosition, isOssAllowedModel, modelAliases, modelHasStoredAuth, OSS_MODEL_ALLOWLIST, OSS_RECOMMENDED_MODEL, offeredRungs, ossFundedModelNames, PROVIDER_GATEWAY_URL_ENV, parseEffortPosition, parseModel, providers, pullfrogMcpName, resolveAutoTier, resolveCliModel, resolveDisplayAlias, resolveModelRung, resolveModelSlug, resolveOpenRouterModel, resolveRung, rungLabel, rungPosition, SUBSIDY_RUNG, } from "../external.ts";
+export type { AuthorPermission, AutoTier, EffortPosition, ModelAlias, ModelProvider, Payload, PayloadEvent, PayloadRouting, ProviderConfig, PushPermission, RouterSource, RouterTier, ShellPermission, ToolPermission, WriteablePayload, XrepoConfig, } from "../external.ts";
+export { AUTO_EFFICIENT, AUTO_INTELLIGENT, AUTO_ROUTER, autoLadder, autoRoutedSlug, DEFAULT_EFFORT_POSITION, DEFAULT_PROXY_MODEL, defaultAutoTier, EFFORT_ALIASES, getAutoSelectHintModel, getModelEffortLevels, getModelEnvVars, getModelManagedCredentials, getModelProvider, getProviderDisplayName, isAutoRouted, isAutoSlug, isAutoTier, isCardGatedModel, isEffortPosition, isOssAllowedModel, isRouterTier, ladderRungs, modelAliases, modelHasStoredAuth, OSS_MODEL_ALLOWLIST, OSS_RECOMMENDED_MODEL, offeredRungs, ossFundedModelNames, PROVIDER_GATEWAY_URL_ENV, parseEffortPosition, parseModel, providers, pullfrogMcpName, ROUTED_PROVIDERS, ROUTER_LADDER, ROUTER_TIERS, resolveAutoTier, resolveCliModel, resolveDisplayAlias, resolveModelRung, resolveModelSlug, resolveOpenRouterModel, resolveRoutedModel, resolveRung, rungLabel, rungPosition, SUBSIDY_RUNG, } from "../external.ts";
 export type { Mode } from "../modes.ts";
 export { modes } from "../modes.ts";
 export { commercialPaywallBody } from "../utils/billingErrors.ts";

package/dist/internal.js

@@ -8,7 +8,7 @@ var __export = (target, all) => {
 // package.json
 var package_default = {
   name: "pullfrog",
-  version: "0.1.76",
+  version: "0.1.77",
   cliContractVersion: "1",
   type: "module",
   bin: {
@@ -15475,6 +15475,97 @@ function resolveAutoTier(params) {
   if (!params.hasCard) return AUTO_EFFICIENT;
   return isAutoTier(params.model) ? params.model : defaultAutoTier(params.hasCard);
 }
+var ROUTER_TIERS = ["minimal", "light", "standard", "deep"];
+function isRouterTier(value) {
+  return typeof value === "string" && ROUTER_TIERS.some((tier) => tier === value);
+}
+var PROVIDER_LADDERS = {
+  anthropic: {
+    minimal: "anthropic/claude-haiku",
+    light: "anthropic/claude-sonnet",
+    standard: "anthropic/claude-opus",
+    deep: "anthropic/claude-opus"
+  },
+  openai: {
+    minimal: "openai/gpt-luna",
+    light: "openai/gpt-terra",
+    standard: "openai/gpt-sol",
+    deep: "openai/gpt-astra"
+  },
+  google: {
+    minimal: "google/gemini-flash",
+    light: "google/gemini-flash",
+    standard: "google/gemini-pro",
+    deep: "google/gemini-pro"
+  },
+  deepseek: {
+    minimal: "deepseek/deepseek-flash",
+    light: "deepseek/deepseek-flash",
+    standard: "deepseek/deepseek-pro",
+    deep: "deepseek/deepseek-pro"
+  },
+  xai: {
+    minimal: "xai/grok-fast",
+    light: "xai/grok-fast",
+    standard: "xai/grok",
+    deep: "xai/grok"
+  },
+  moonshotai: {
+    minimal: "moonshotai/kimi-k2",
+    light: "moonshotai/kimi-k2",
+    standard: "moonshotai/kimi-k3",
+    deep: "moonshotai/kimi-k3"
+  },
+  openrouter: {
+    minimal: "openrouter/deepseek-flash",
+    light: "openrouter/gpt-luna",
+    standard: "openrouter/gpt-sol",
+    deep: "openrouter/claude-opus"
+  },
+  opencode: {
+    minimal: "opencode/gpt-luna",
+    light: "opencode/gpt-luna",
+    standard: "opencode/gpt-sol",
+    deep: "opencode/claude-opus"
+  }
+};
+var ROUTER_LADDER = {
+  minimal: "deepseek/deepseek-flash",
+  light: "openai/gpt-luna",
+  standard: "openai/gpt-sol",
+  deep: "anthropic/claude-opus"
+};
+var AUTO_ROUTER = "auto/router";
+var AUTO_PREFIX = "auto/";
+function autoLadder(slug) {
+  if (!slug || !slug.startsWith(AUTO_PREFIX) || isAutoTier(slug)) return void 0;
+  const target = slug.slice(AUTO_PREFIX.length);
+  return target === "router" ? ROUTER_LADDER : PROVIDER_LADDERS[target];
+}
+function isAutoRouted(slug) {
+  return autoLadder(slug) !== void 0;
+}
+function isAutoSlug(slug) {
+  return isAutoTier(slug) || isAutoRouted(slug);
+}
+function autoRoutedSlug(provider2) {
+  return `${AUTO_PREFIX}${provider2}`;
+}
+var ROUTED_PROVIDERS = Object.keys(
+  PROVIDER_LADDERS
+).map((key) => ({ key, displayName: providers[key].displayName }));
+function ladderRungs(ladder) {
+  const rungs = [];
+  for (const tier of ROUTER_TIERS) {
+    const last = rungs[rungs.length - 1];
+    if (last?.slug === ladder[tier]) last.tiers.push(tier);
+    else rungs.push({ slug: ladder[tier], tiers: [tier] });
+  }
+  return rungs;
+}
+function resolveRoutedModel(params) {
+  return autoLadder(params.configured)?.[params.tier];
+}
 function isCardGatedModel(slug) {
   return resolveOpenRouterModel(slug) !== void 0;
 }
@@ -15483,7 +15574,7 @@ function resolveModelSlug(slug) {
 }
 var MAX_FALLBACK_DEPTH = 10;
 function resolveDisplayAlias(slug) {
-  let current = isAutoTier(slug) ? AUTO_TIER_TARGET[slug] : slug;
+  let current = isAutoTier(slug) ? AUTO_TIER_TARGET[slug] : autoLadder(slug)?.standard ?? slug;
   const visited = /* @__PURE__ */ new Set();
   for (let i = 0; i < MAX_FALLBACK_DEPTH; i++) {
     if (visited.has(current)) return void 0;
@@ -15518,6 +15609,11 @@ if (!defaultProxyAlias?.openRouterResolve) {
 }
 var DEFAULT_PROXY_MODEL = defaultProxyAlias.openRouterResolve;
 var defaultProxyDisplayName = defaultProxyAlias.displayName;
+for (const [name, ladder] of Object.entries({ ...PROVIDER_LADDERS, router: ROUTER_LADDER })) {
+  for (const slug of Object.values(ladder)) {
+    if (!resolveDisplayAlias(slug)) throw new Error(`${name} ladder names unknown alias ${slug}`);
+  }
+}
 var OSS_MODEL_ALLOWLIST = [
   "deepseek/deepseek-flash",
   "deepseek/deepseek-pro",
@@ -16599,6 +16695,7 @@ export {
   APPROVAL_CHECK_NAME,
   AUTO_EFFICIENT,
   AUTO_INTELLIGENT,
+  AUTO_ROUTER,
   CLI_CONTRACT_HEADER,
   CLI_CONTRACT_VERSION,
   CLI_UPGRADE_MESSAGE,
@@ -16612,9 +16709,14 @@ export {
   OSS_RECOMMENDED_MODEL,
   PROVIDER_GATEWAY_URL_ENV,
   PULLFROG_DIVIDER,
+  ROUTED_PROVIDERS,
+  ROUTER_LADDER,
+  ROUTER_TIERS,
   RUN_STATUS_CHECK_NAME,
   SUBSIDY_RUNG,
   TIMEOUT_DISABLED,
+  autoLadder,
+  autoRoutedSlug,
   buildPullfrogFooter,
   commercialPaywallBody,
   configEntrySchema,
@@ -16634,6 +16736,8 @@ export {
   getModelProvider,
   getProgressComment,
   getProviderDisplayName,
+  isAutoRouted,
+  isAutoSlug,
   isAutoTier,
   isCardGatedModel,
   isCredentialProbeable,
@@ -16641,7 +16745,9 @@ export {
   isLeapingIntoActionCommentBody,
   isOssAllowedModel,
   isPullfrog,
+  isRouterTier,
   isValidTimeString,
+  ladderRungs,
   modelAliases,
   modelHasStoredAuth,
   modes,
@@ -16662,6 +16768,7 @@ export {
   resolveModelRung,
   resolveModelSlug,
   resolveOpenRouterModel,
+  resolveRoutedModel,
   resolveRung,
   runStatusCheckNeedsFinalizing,
   rungLabel,

package/dist/models.d.ts

@@ -218,6 +218,58 @@ export declare function resolveAutoTier(params: {
     model: string | null;
     hasCard: boolean;
 }): AutoTier;
+/**
+ * the four rungs the model router scores a review into, ascending. `minimal` is
+ * a PR with no behavioural surface, `deep` one whose defects are absences the
+ * diff does not show. see wiki/router.md for how a tier is earned.
+ */
+export declare const ROUTER_TIERS: readonly ["minimal", "light", "standard", "deep"];
+export type RouterTier = (typeof ROUTER_TIERS)[number];
+export declare function isRouterTier(value: unknown): value is RouterTier;
+type Ladder = Record<RouterTier, string>;
+/**
+ * the Router's own ladder for an account on `auto/router` with a card on
+ * file. an account without a card is never routed onto this:
+ * `resolveAutoTier` clamps it to the efficient default at every tier, exactly
+ * as before the router existed.
+ */
+export declare const ROUTER_LADDER: Ladder;
+/**
+ * the `repo.model` sentinel that turns the router on: `auto/<provider>` runs
+ * each piece of work on that provider's ladder, `auto/router` on the Pullfrog
+ * Router's. distinct from the two managed tiers above, which each name ONE
+ * model. a Pro feature — outside Pro the sentinel simply runs its ladder's
+ * `standard` rung, which is what `resolveDisplayAlias` resolves it to.
+ */
+export declare const AUTO_ROUTER = "auto/router";
+/** the ladder an Auto sentinel routes on; undefined for a tier or a pin */
+export declare function autoLadder(slug: string | null | undefined): Ladder | undefined;
+export declare function isAutoRouted(slug: string | null | undefined): boolean;
+/** any `auto/*` sentinel — a managed tier or the router — as opposed to a concrete pin */
+export declare function isAutoSlug(slug: string | null | undefined): boolean;
+export declare function autoRoutedSlug(provider: string): string;
+/** the providers a BYOK repo can put on Auto — exactly the ones with a ladder */
+export declare const ROUTED_PROVIDERS: readonly {
+    key: string;
+    displayName: string;
+}[];
+/**
+ * a ladder's distinct models in ascending order, each with the tiers it
+ * serves — the console's "what Auto runs on" list, where a model that covers
+ * two tiers is one row.
+ */
+export declare function ladderRungs(ladder: Ladder): {
+    slug: string;
+    tiers: RouterTier[];
+}[];
+/**
+ * the model a routed run takes: the tier's rung on the ladder the configured
+ * Auto sentinel names. undefined for a pin — a pin opts out of routing.
+ */
+export declare function resolveRoutedModel(params: {
+    configured: string | null | undefined;
+    tier: RouterTier;
+}): string | undefined;
 /**
  * Router-resolvable — the set a card on file unlocks. custom (non-Auto) picks
  * are card-gated wholesale on the Router: the console locks the Custom tab

package/dist/utils/payload.d.ts

@@ -7,6 +7,13 @@ export declare const JsonPayload: import("arktype/internal/variants/object.ts").
     type?: string | undefined;
     model?: string | undefined;
     modelExplicit?: boolean | undefined;
+    routing?: {
+        tier: "minimal" | "light" | "standard" | "deep";
+        stakes: number;
+        workload: number;
+        source: "scorer" | "heuristic" | "fixed";
+        rationale: string;
+    } | undefined;
     effort?: string | number | undefined;
     debug?: boolean | undefined;
     triggerer?: string | undefined;
@@ -54,6 +61,13 @@ export declare function resolvePayload(resolvedPromptInput: ResolvedPromptInput,
     version: string;
     model: string | undefined;
     modelExplicit: boolean;
+    routing: {
+        tier: "minimal" | "light" | "standard" | "deep";
+        stakes: number;
+        workload: number;
+        source: "scorer" | "heuristic" | "fixed";
+        rationale: string;
+    } | undefined;
     effort: number | undefined;
     debug: true | undefined;
     prompt: string;

package/dist/utils/runContext.d.ts

@@ -1,4 +1,5 @@
 import type { PushPermission, ShellPermission } from "../external.ts";
+import type { RouterTier } from "../models.ts";
 import type { RepoContext } from "./github.ts";
 export interface Mode {
     id: string;
@@ -104,4 +105,7 @@ export declare function fetchRunContext(params: {
     /** `payload.type` — lets the server apply this repo's per-trigger model
      * override, which it cannot derive from owner/repo alone. */
     runType?: string | undefined;
+    /** `payload.routing.tier` — the model router's tier, which run-context
+     * applies to the Router proxy mint the same way it applies `runType`. */
+    routedTier?: RouterTier | undefined;
 }): Promise<RunContext>;

package/dist/utils/runContextData.d.ts

@@ -1,4 +1,5 @@
 import type { Octokit } from "@octokit/rest";
+import type { RouterTier } from "../models.ts";
 import { type OctokitWithPlugins } from "./github.ts";
 import { type AccountPlan, type CommercialRefusal, type RepoSettings } from "./runContext.ts";
 export interface RunContextData {
@@ -33,6 +34,8 @@ interface ResolveRunContextDataParams {
      * because run-context is fetched first and needs it to pick this trigger's
      * model override. */
     runType?: string | undefined;
+    /** the model router's tier from the payload, forwarded so run-context applies it to the proxy mint. */
+    routedTier?: RouterTier | undefined;
 }
 /**
  * initialize run context data: parse context, fetch repo info and settings

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pullfrog",
-  "version": "0.1.76",
+  "version": "0.1.77",
   "cliContractVersion": "1",
   "type": "module",
   "bin": {