pullfrog 0.1.47 → 0.1.49

package/dist/internal/index.d.ts

@@ -2,10 +2,11 @@
  * Internal entrypoint for the root app.
  * Re-exports shared types, values, and utilities needed by the Next.js app.
  */
-export type { AuthorPermission, AutoTier, ModelAlias, ModelProvider, Payload, PayloadEvent, ProviderConfig, PushPermission, ShellPermission, ToolPermission, WriteablePayload, XrepoConfig, } from "../external.ts";
-export { AUTO_EFFICIENT, AUTO_INTELLIGENT, DEFAULT_PROXY_MODEL, defaultAutoTier, getAutoSelectHintModel, getModelEnvVars, getModelManagedCredentials, getModelProvider, getProviderDisplayName, isAutoTier, isCardGatedModel, modelAliases, parseModel, providers, pullfrogMcpName, resolveAutoTier, resolveCliModel, resolveDisplayAlias, resolveModelSlug, resolveOpenRouterModel, } from "../external.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, modelAliases, offeredRungs, parseEffortPosition, parseModel, providers, pullfrogMcpName, resolveAutoTier, resolveCliModel, resolveDisplayAlias, resolveModelRung, resolveModelSlug, resolveOpenRouterModel, resolveRung, rungLabel, rungPosition, } from "../external.ts";
 export type { Mode } from "../modes.ts";
 export { modes } from "../modes.ts";
+export { commercialPaywallBody } from "../utils/billingErrors.ts";
 export type { BuildPullfrogFooterParams, WorkflowRunFooterInfo, } from "../utils/buildPullfrogFooter.ts";
 export { buildPullfrogFooter, PULLFROG_DIVIDER, stripExistingFooter, } from "../utils/buildPullfrogFooter.ts";
 export type { CodexAuthBody } from "../utils/codexOAuth.ts";

package/dist/internal.js

@@ -1,5 +1,53 @@
 import { createRequire as __createRequire } from 'module'; import { fileURLToPath as __fileURLToPath } from 'url'; import { dirname as __dirnameFn } from 'path'; const require = __createRequire(import.meta.url); const __filename = __fileURLToPath(import.meta.url); const __dirname = __dirnameFn(__filename);
 
+// effort.ts
+var DEFAULT_EFFORT_POSITION = 0.5;
+var EFFORT_ALIASES = {
+  low: 0,
+  medium: 0.25,
+  high: 0.5,
+  xhigh: 0.75,
+  max: 1
+};
+var DISABLING_RUNGS = ["none", "minimal"];
+function isEffortPosition(value) {
+  return Number.isFinite(value) && value >= 0 && value <= 1;
+}
+function parseEffortPosition(raw) {
+  const normalized = raw.trim().toLowerCase();
+  const named = EFFORT_ALIASES[normalized === "med" ? "medium" : normalized];
+  if (named !== void 0) return named;
+  const numeric = Number(normalized);
+  return normalized !== "" && isEffortPosition(numeric) ? numeric : void 0;
+}
+function offeredRungs(published) {
+  return published.filter((rung) => !DISABLING_RUNGS.includes(rung));
+}
+function resolveRung(params) {
+  const rungs = offeredRungs(params.published);
+  if (rungs.length === 0) return void 0;
+  const clamped = Math.min(1, Math.max(0, params.position));
+  return rungs[Math.floor(clamped * (rungs.length - 1))];
+}
+function rungPosition(params) {
+  const rungs = offeredRungs(params.published);
+  const index = rungs.indexOf(params.rung);
+  if (index === -1) return void 0;
+  return rungs.length > 1 ? index / (rungs.length - 1) : 0;
+}
+function rungLabel(rung) {
+  const known = {
+    none: "None",
+    minimal: "Minimal",
+    low: "Low",
+    medium: "Medium",
+    high: "High",
+    xhigh: "Extra high",
+    max: "Max"
+  };
+  return known[rung] ?? rung.charAt(0).toUpperCase() + rung.slice(1);
+}
+
 // models.ts
 function provider(config) {
   return config;
@@ -19,6 +67,7 @@ var providers = {
       "claude-fable": {
         displayName: "Claude Fable",
         resolve: "anthropic/claude-fable-5",
+        effort: ["low", "medium", "high", "xhigh", "max"],
         // rolling alias: models.dev's OpenRouter mirror lags brand-new pinned
         // versions (claude-fable-5 isn't indexed yet), so track ~…-latest to
         // stay catalog-valid and auto-follow version bumps.
@@ -28,6 +77,7 @@ var providers = {
       "claude-opus": {
         displayName: "Claude Opus",
         resolve: "anthropic/claude-opus-5",
+        effort: ["low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/anthropic/claude-opus-5",
         preferred: true,
         subagentModel: "claude-sonnet"
@@ -35,6 +85,7 @@ var providers = {
       "claude-sonnet": {
         displayName: "Claude Sonnet",
         resolve: "anthropic/claude-sonnet-5",
+        effort: ["low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/anthropic/claude-sonnet-5"
       },
       "claude-haiku": {
@@ -52,6 +103,7 @@ var providers = {
       gpt: {
         displayName: "GPT Sol",
         resolve: "openai/gpt-5.6-sol",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/openai/gpt-5.6-sol",
         preferred: true,
         subagentModel: "gpt-terra"
@@ -63,6 +115,7 @@ var providers = {
         displayName: "GPT Sol Pro",
         description: "Maximum reasoning effort",
         resolve: "openai/gpt-5.6-sol",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/openai/gpt-5.6-sol-pro",
         subagentModel: "gpt"
       },
@@ -72,11 +125,13 @@ var providers = {
       "gpt-terra": {
         displayName: "GPT Terra",
         resolve: "openai/gpt-5.6-terra",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/openai/gpt-5.6-terra"
       },
       "gpt-mini": {
         displayName: "GPT Luna",
         resolve: "openai/gpt-5.6-luna",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/openai/gpt-5.6-luna"
       },
       // legacy aliases — openai unified the codex line into the main GPT family
@@ -106,6 +161,7 @@ var providers = {
       o3: {
         displayName: "O3",
         resolve: "openai/o3",
+        effort: ["low", "medium", "high"],
         openRouterResolve: "openrouter/openai/o3"
       }
     }
@@ -117,6 +173,7 @@ var providers = {
       "gemini-pro": {
         displayName: "Gemini Pro",
         resolve: "google/gemini-3.1-pro-preview",
+        effort: ["low", "medium", "high"],
         openRouterResolve: "openrouter/google/gemini-3.1-pro-preview",
         preferred: true
         // Inherit (subagents stay on Pro). Google has no in-between tier;
@@ -128,6 +185,7 @@ var providers = {
       "gemini-flash": {
         displayName: "Gemini Flash",
         resolve: "google/gemini-3.5-flash",
+        effort: ["minimal", "low", "medium", "high"],
         openRouterResolve: "openrouter/google/gemini-3.5-flash"
       }
     }
@@ -139,6 +197,7 @@ var providers = {
       grok: {
         displayName: "Grok",
         resolve: "xai/grok-4.3",
+        effort: ["none", "low", "medium", "high"],
         openRouterResolve: "openrouter/x-ai/grok-4.3",
         preferred: true
       },
@@ -168,12 +227,16 @@ var providers = {
       "deepseek-pro": {
         displayName: "DeepSeek Pro",
         resolve: "deepseek/deepseek-v4-pro",
+        effort: ["high", "max"],
+        openRouterEffort: ["high", "xhigh"],
         openRouterResolve: "openrouter/deepseek/deepseek-v4-pro",
         preferred: true
       },
       "deepseek-flash": {
         displayName: "DeepSeek Flash",
         resolve: "deepseek/deepseek-v4-flash",
+        effort: ["high", "max"],
+        openRouterEffort: ["high", "xhigh"],
         openRouterResolve: "openrouter/deepseek/deepseek-v4-flash"
       },
       // legacy aliases — deepseek retires these on 2026-07-24; transparently
@@ -202,6 +265,7 @@ var providers = {
       "kimi-k3": {
         displayName: "Kimi K3",
         resolve: "moonshotai/kimi-k3",
+        effort: ["low", "high", "max"],
         openRouterResolve: "openrouter/moonshotai/kimi-k3",
         preferred: true,
         subagentModel: "kimi-k2"
@@ -214,7 +278,7 @@ var providers = {
     }
   }),
   opencode: provider({
-    displayName: "OpenCode",
+    displayName: "OpenCode Zen",
     envVars: ["OPENCODE_API_KEY"],
     models: {
       "big-pickle": {
@@ -227,12 +291,14 @@ var providers = {
       "claude-opus": {
         displayName: "Claude Opus",
         resolve: "opencode/claude-opus-5",
+        effort: ["low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/anthropic/claude-opus-5",
         subagentModel: "claude-sonnet"
       },
       "claude-sonnet": {
         displayName: "Claude Sonnet",
         resolve: "opencode/claude-sonnet-5",
+        effort: ["low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/anthropic/claude-sonnet-5"
       },
       "claude-haiku": {
@@ -243,6 +309,7 @@ var providers = {
       gpt: {
         displayName: "GPT Sol",
         resolve: "opencode/gpt-5.6-sol",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/openai/gpt-5.6-sol",
         subagentModel: "gpt-terra"
       },
@@ -251,6 +318,7 @@ var providers = {
         displayName: "GPT Sol Pro",
         description: "Maximum reasoning effort",
         resolve: "opencode/gpt-5.6-sol",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/openai/gpt-5.6-sol-pro",
         subagentModel: "gpt"
       },
@@ -258,11 +326,13 @@ var providers = {
       "gpt-terra": {
         displayName: "GPT Terra",
         resolve: "opencode/gpt-5.6-terra",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/openai/gpt-5.6-terra"
       },
       "gpt-mini": {
         displayName: "GPT Luna",
         resolve: "opencode/gpt-5.6-luna",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/openai/gpt-5.6-luna"
       },
       // legacy aliases — see openai provider above for context.
@@ -288,12 +358,14 @@ var providers = {
       "gemini-pro": {
         displayName: "Gemini Pro",
         resolve: "opencode/gemini-3.1-pro",
+        effort: ["low", "medium", "high"],
         openRouterResolve: "openrouter/google/gemini-3.1-pro-preview"
         // Inherit — see google/gemini-pro for rationale.
       },
       "gemini-flash": {
         displayName: "Gemini Flash",
         resolve: "opencode/gemini-3.5-flash",
+        effort: ["minimal", "low", "medium", "high"],
         openRouterResolve: "openrouter/google/gemini-3.5-flash"
       },
       "kimi-k2": {
@@ -312,6 +384,7 @@ var providers = {
       "gpt-5-nano": {
         displayName: "GPT Nano",
         resolve: "opencode/gpt-5-nano",
+        effort: ["minimal", "low", "medium", "high"],
         openRouterResolve: "openrouter/openai/gpt-5-nano"
       },
       "mimo-v2-pro-free": {
@@ -338,6 +411,8 @@ var providers = {
       "glm-5.1": {
         displayName: "GLM 5.2",
         resolve: "opencode-go/glm-5.2",
+        effort: ["high", "max"],
+        openRouterEffort: ["high", "xhigh"],
         openRouterResolve: "openrouter/z-ai/glm-5.2",
         preferred: true
       },
@@ -391,6 +466,10 @@ var providers = {
     // bring-your-own generic OpenAI-compatible endpoint — Cloudflare AI Gateway,
     // Alibaba DashScope, self-hosted vLLM, or any compatible gateway. base URL +
     // key + model ID are all supplied via env; nothing is cataloged or bumped.
+    // the two token limits are deliberately absent: this list is the auth
+    // heuristic (`hasPullfrogStoredAuthForModel`, `validateAgentApiKey`), and a
+    // stored context number is config, not proof of a key. the console picks
+    // them up from `PROVIDER_EXTRA_SECRET_NAMES` instead.
     envVars: ["OPENAI_COMPATIBLE_BASE_URL", "OPENAI_COMPATIBLE_API_KEY", "OPENAI_COMPATIBLE_MODEL"],
     models: {
       // single routing entry — the actual model ID is read from
@@ -410,6 +489,7 @@ var providers = {
       "claude-opus": {
         displayName: "Claude Opus",
         resolve: "openrouter/~anthropic/claude-opus-latest",
+        effort: ["low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/~anthropic/claude-opus-latest",
         preferred: true,
         subagentModel: "claude-sonnet"
@@ -417,6 +497,7 @@ var providers = {
       "claude-sonnet": {
         displayName: "Claude Sonnet",
         resolve: "openrouter/~anthropic/claude-sonnet-latest",
+        effort: ["low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/~anthropic/claude-sonnet-latest"
       },
       "claude-haiku": {
@@ -431,6 +512,7 @@ var providers = {
       gpt: {
         displayName: "GPT Sol",
         resolve: "openrouter/openai/gpt-5.6-sol",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/openai/gpt-5.6-sol",
         subagentModel: "gpt-terra"
       },
@@ -439,6 +521,7 @@ var providers = {
         displayName: "GPT Sol Pro",
         description: "Maximum reasoning effort",
         resolve: "openrouter/openai/gpt-5.6-sol-pro",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/openai/gpt-5.6-sol-pro",
         subagentModel: "gpt"
       },
@@ -446,11 +529,13 @@ var providers = {
       "gpt-terra": {
         displayName: "GPT Terra",
         resolve: "openrouter/openai/gpt-5.6-terra",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/openai/gpt-5.6-terra"
       },
       "gpt-mini": {
         displayName: "GPT Luna",
         resolve: "openrouter/openai/gpt-5.6-luna",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"],
         openRouterResolve: "openrouter/openai/gpt-5.6-luna"
       },
       // legacy aliases — see openai provider for context.
@@ -476,32 +561,38 @@ var providers = {
       "o4-mini": {
         displayName: "O4 Mini",
         resolve: "openrouter/openai/o4-mini",
+        effort: ["low", "medium", "high"],
         openRouterResolve: "openrouter/openai/o4-mini"
       },
       "gemini-pro": {
         displayName: "Gemini Pro",
         resolve: "openrouter/~google/gemini-pro-latest",
+        effort: ["low", "medium", "high"],
         openRouterResolve: "openrouter/~google/gemini-pro-latest"
         // Inherit — see google/gemini-pro for rationale.
       },
       "gemini-flash": {
         displayName: "Gemini Flash",
         resolve: "openrouter/~google/gemini-flash-latest",
+        effort: ["minimal", "low", "medium", "high"],
         openRouterResolve: "openrouter/~google/gemini-flash-latest"
       },
       grok: {
         displayName: "Grok",
         resolve: "openrouter/x-ai/grok-4.3",
+        effort: ["none", "low", "medium", "high"],
         openRouterResolve: "openrouter/x-ai/grok-4.3"
       },
       "deepseek-pro": {
         displayName: "DeepSeek Pro",
         resolve: "openrouter/deepseek/deepseek-v4-pro",
+        effort: ["high", "xhigh"],
         openRouterResolve: "openrouter/deepseek/deepseek-v4-pro"
       },
       "deepseek-flash": {
         displayName: "DeepSeek Flash",
         resolve: "openrouter/deepseek/deepseek-v4-flash",
+        effort: ["high", "xhigh"],
         openRouterResolve: "openrouter/deepseek/deepseek-v4-flash"
       },
       // legacy alias — deepseek retires this on 2026-07-24; transparently
@@ -520,6 +611,7 @@ var providers = {
       "kimi-k3": {
         displayName: "Kimi K3",
         resolve: "openrouter/moonshotai/kimi-k3",
+        effort: ["low", "high", "max"],
         openRouterResolve: "openrouter/moonshotai/kimi-k3"
       },
       // slug pins the m2 line for DB stability; resolve tracks the current m2.7.
@@ -583,6 +675,8 @@ var modelAliases = Object.entries(providers).flatMap(
     // here to a fully-qualified slug so callers can look up the target alias
     // directly without re-deriving the provider.
     subagentModel: def.subagentModel ? `${providerKey}/${def.subagentModel}` : void 0,
+    effort: def.effort,
+    openRouterEffort: def.openRouterEffort,
     hidden: def.hidden ?? false
   }))
 );
@@ -628,6 +722,17 @@ function resolveCliModel(slug) {
 function resolveOpenRouterModel(slug) {
   return resolveDisplayAlias(slug)?.openRouterResolve;
 }
+function getModelEffortLevels(params) {
+  const alias = resolveDisplayAlias(params.slug);
+  if (!alias) return void 0;
+  if (params.useOpenRouter) return alias.openRouterEffort ?? alias.effort;
+  return alias.effort;
+}
+function resolveModelRung(params) {
+  const published = getModelEffortLevels(params);
+  if (!published) return void 0;
+  return resolveRung({ position: params.position, published });
+}
 var defaultProxyAlias = resolveDisplayAlias(AUTO_EFFICIENT);
 if (!defaultProxyAlias?.openRouterResolve) {
   throw new Error(`DEFAULT_PROXY_MODEL: ${AUTO_EFFICIENT} has no openRouterResolve`);
@@ -1043,6 +1148,27 @@ ${PR_SUMMARY_FORMAT}`
 }
 var modes = computeModes("opencode");
 
+// utils/billingErrors.ts
+function commercialPaywallBody(params) {
+  if (params.reason === "commercial") {
+    return [
+      `**Pullfrog needs a confirmed Pro plan for ${params.ownerLogin}, so this run paused.**`,
+      "",
+      "Open Plan and payment to confirm Pro or review the organization's billing status.",
+      "",
+      `[Review plan and payment \u2192](${params.url})`
+    ].join("\n");
+  }
+  params.reason;
+  return [
+    `**Pullfrog paused runs on ${params.ownerLogin}: the Pro renewal failed.**`,
+    "",
+    "Update the card on file to resume runs.",
+    "",
+    `[Update billing \u2192](${params.url})`
+  ].join("\n");
+}
+
 // utils/buildPullfrogFooter.ts
 var PULLFROG_DIVIDER = "<!-- PULLFROG_DIVIDER_DO_NOT_REMOVE_PLZ -->";
 var FROG_LOGO = `<a href="https://pullfrog.com"><picture><source media="(prefers-color-scheme: dark)" srcset="https://pullfrog.com/logos/frog-white-full-18px.png"><img src="https://pullfrog.com/logos/frog-green-full-18px.png" width="9px" height="9px" style="vertical-align: middle; " alt="Pullfrog"></picture></a>`;
@@ -1454,7 +1580,9 @@ export {
   APPROVAL_CHECK_NAME,
   AUTO_EFFICIENT,
   AUTO_INTELLIGENT,
+  DEFAULT_EFFORT_POSITION,
   DEFAULT_PROXY_MODEL,
+  EFFORT_ALIASES,
   LEAPING_INTO_ACTION_PREFIX,
   MAX_LEARNINGS_LENGTH,
   OAuthInvalidGrantError,
@@ -1462,6 +1590,7 @@ export {
   RUN_STATUS_CHECK_NAME,
   TIMEOUT_DISABLED,
   buildPullfrogFooter,
+  commercialPaywallBody,
   createLeapingProgressComment,
   createRunStatusCheck,
   decodeJwtExpMs,
@@ -1469,6 +1598,7 @@ export {
   deleteProgressCommentApi,
   finalizeRunStatusCheck,
   getAutoSelectHintModel,
+  getModelEffortLevels,
   getModelEnvVars,
   getModelManagedCredentials,
   getModelProvider,
@@ -1476,11 +1606,14 @@ export {
   getProviderDisplayName,
   isAutoTier,
   isCardGatedModel,
+  isEffortPosition,
   isLeapingIntoActionCommentBody,
   isValidTimeString,
   modelAliases,
   modes,
+  offeredRungs,
   parseCodexAuthBody,
+  parseEffortPosition,
   parseModel,
   parseTimeString,
   providers,
@@ -1489,9 +1622,13 @@ export {
   resolveAutoTier,
   resolveCliModel,
   resolveDisplayAlias,
+  resolveModelRung,
   resolveModelSlug,
   resolveOpenRouterModel,
+  resolveRung,
   runStatusCheckNeedsFinalizing,
+  rungLabel,
+  rungPosition,
   stringifyCodexAuthBody,
   stripExistingFooter,
   truncateAtLineBoundary,

package/dist/models.d.ts

@@ -4,6 +4,7 @@
  * slugs use the format `provider/model-id` (e.g. "anthropic/claude-opus").
  * bump `resolve` when a new model generation ships — the alias (slug) stays stable.
  */
+import { type EffortPosition } from "./effort.ts";
 /**
  * routing discriminant for entries whose `resolve` is dynamic — looked up
  * from a separate env var at run time rather than fixed in the catalog.
@@ -50,6 +51,14 @@ export interface ModelAlias {
     /** alias key (within same provider) of the cheaper sibling reviewfrog should
      * use as its lens-fanout subagent. e.g. claude-opus → "claude-sonnet". */
     subagentModel: string | undefined;
+    /** reasoning-effort rungs this model accepts on the direct route, ascending.
+     * mirrors models.dev `reasoning_options[type=effort].values`. undefined means
+     * the model has no effort control and the setting is a documented no-op. */
+    effort: readonly string[] | undefined;
+    /** effort rungs on the OpenRouter route, when they differ from `effort` (the
+     * DeepSeek/GLM top rung is `max` natively but `xhigh` via OpenRouter).
+     * undefined falls back to `effort`. */
+    openRouterEffort: readonly string[] | undefined;
     /** hide from selectable lists (UI dropdowns, CLI pickers). does NOT affect
      * resolution — for that use `fallback`. used to keep a redundant alias out of
      * pickers (e.g. the free `minimax-m2.5-free` duplicate). */
@@ -75,6 +84,10 @@ interface ModelDef {
     /** alias key (within same provider) of the cheaper sibling reviewfrog should
      * use as its lens-fanout subagent (e.g. claude-opus → "claude-sonnet"). */
     subagentModel?: string;
+    /** effort rungs accepted on the direct route, ascending — see ModelAlias.effort */
+    effort?: readonly string[];
+    /** effort rungs on the OpenRouter route when they differ — see ModelAlias.openRouterEffort */
+    openRouterEffort?: readonly string[];
     /** hide from selectable lists. does NOT affect resolution; for that use `fallback`. */
     hidden?: boolean;
 }
@@ -123,8 +136,8 @@ export declare const modelAliases: ModelAlias[];
  * (CLI resolve, OpenRouter resolve, footer label) handles them transparently.
  *
  * `efficient` mirrors the OSS/default subsidy model (DeepSeek V4 Pro — beats
- * Kimi K2.7 on agentic-review quality at ~4-5x lower cost, run at high
- * reasoning effort via `deepseekHighEffortOverrides`); `intelligent` is the
+ * Kimi K2.7 on agentic-review quality at ~4-5x lower cost, run at whatever
+ * effort the repo asks for, clamped to its published ladder); `intelligent` is the
  * frontier pick (Claude Opus). a `null` model means the tier hasn't been
  * pinned: callers default by card status via `defaultAutoTier`.
  */
@@ -190,6 +203,27 @@ export declare function resolveCliModel(slug: string): string | undefined;
  * (e.g. free opencode models).
  */
 export declare function resolveOpenRouterModel(slug: string): string | undefined;
+/**
+ * the effort rungs `slug` accepts on the route being used, or undefined when the
+ * model has no effort control at all. walks the fallback chain, so a deprecated
+ * slug is judged by the model that actually runs. drives both the console's
+ * level list and the runtime clamp, so the two can't disagree.
+ */
+export declare function getModelEffortLevels(params: {
+    slug: string;
+    useOpenRouter: boolean;
+}): readonly string[] | undefined;
+/**
+ * the rung a run actually sends: a position landed on this model's own published
+ * ladder. the result is always a rung the model offers, so there is no arithmetic
+ * anywhere that can produce a level it doesn't have. undefined means the model
+ * publishes no rungs and the harness gets no flag.
+ */
+export declare function resolveModelRung(params: {
+    slug: string;
+    position: EffortPosition;
+    useOpenRouter: boolean;
+}): string | undefined;
 export declare const DEFAULT_PROXY_MODEL: string;
 /** short label for the model auto-select picks today (console hint copy). */
 export declare function getAutoSelectHintModel(): string;

package/dist/utils/billingErrors.d.ts

@@ -13,8 +13,8 @@
  * in `action/test/coverage.ts::ALWAYS_RUN_ALL`).
  */
 /**
- * Billing-layer error surfaced from `/api/proxy-token` as a 402. User-actionable
- * — distinct from TransientError (503 / transient sync issue) so the job
+ * Billing-layer error surfaced from `/api/proxy-token` as a 402. User-actionable,
+ * distinct from TransientError (503 / transient sync issue) so the job
  * summary + PR comment can use affirmative "you need to do X" copy rather than
  * the ambiguous "billing error" label that makes transient outages look like
  * the user's fault.
@@ -37,28 +37,45 @@ export declare class BillingError extends Error {
 }
 /**
  * Transient service failures from `/api/proxy-token` (503: partial OpenRouter
- * usage sync, DB flake, in-flight payment intent). Not the user's fault — the
+ * usage sync, DB flake, in-flight payment intent). Not the user's fault, the
  * summary uses "temporarily unavailable" framing, and the non-zero exit lets
  * GH Actions apply whatever retry policy the workflow has configured.
  */
 export declare class TransientError extends Error {
     constructor(message: string);
 }
+/**
+ * Canonical paused-run paywall body (billing model v2). Single source of truth so
+ * the two surfaces that show it can never drift: the trigger-time comment (a run
+ * refused before it starts, `triggerWorkflow.postPaywallComment`) and the mid-run
+ * 402 render (`formatBillingErrorSummary` via `renderRunError`). `url` is the
+ * caller's billing surface (each passes its own, internal plan page vs console).
+ */
+export declare function commercialPaywallBody(params: {
+    reason: "commercial" | "subscription_unpaid";
+    ownerLogin: string;
+    url: string;
+}): string;
+/** commercial-gate copy for action runs, linked to the account billing card. */
+export declare function formatCommercialGateSummary(params: {
+    reason: "commercial" | "subscription_unpaid";
+    ownerLogin: string;
+}): string;
 /**
  * Render a BillingError as user-facing markdown (shared between GH job summary
  * and the PR progress comment). Goals:
  *
- *   - quiet, not alarmist — bold first line instead of an `### ❌` H3, since
+ *   - quiet, not alarmist, bold first line instead of an `### ❌` H3, since
  *     the comment already has Pullfrog branding in the footer
- *   - actionable — every branch ends in a single CTA deep-linked to the
+ *   - actionable, every branch ends in a single CTA deep-linked to the
  *     correct section of the owner's console
- *   - honest — say what actually went wrong (card declined vs. balance
+ *   - honest, say what actually went wrong (card declined vs. balance
  *     empty vs. 3DS required), don't lump them under "billing error"
  *
  * Branches:
  *   - `router_requires_card`: user is on Router mode with no card AND no
- *     wallet balance (signup credit exhausted or not granted). Frame as
- *     "add a card to continue", link to `#model-access` where the Add
+ *     wallet balance. Frame as
+ *     "add a card to continue", link to `#billing` where the Add
  *     Card flow lives.
  *   - `router_balance_exhausted`: user has a card on file but auto-reload is
  *     disabled and they've spent past their $5 overdraft buffer. Frame as
@@ -69,7 +86,7 @@ export declare class TransientError extends Error {
  *     wallet is now negative; same remediation as `router_balance_exhausted`
  *     but framed for the after-the-fact case ("this run was cut short").
  *   - `needsReauthentication`: issuer requires 3DS on every off-session
- *     charge. Re-adding the card won't help — the only escape is a manual
+ *     charge. Re-adding the card won't help, the only escape is a manual
  *     top-up where 3DS runs interactively in Stripe Checkout.
  *   - `declineCode` set: Stripe declined a real charge. Show the sub-code
  *     so support can act on it; tell the user we'll retry on next dispatch.
@@ -80,6 +97,6 @@ export declare function formatBillingErrorSummary(error: BillingError, owner: st
 /**
  * Render a TransientError as user-facing markdown. Distinct framing from
  * BillingError so the user doesn't read an alarm and assume their card
- * failed — this branch is "our fault, retry shortly", not theirs.
+ * failed, this branch is "our fault, retry shortly", not theirs.
  */
 export declare function formatTransientErrorSummary(error: TransientError, owner: string): string;

package/dist/utils/payload.d.ts

@@ -1,4 +1,4 @@
-import type { PayloadEvent } from "../external.ts";
+import { type PayloadEvent } from "../external.ts";
 import type { RepoSettings } from "./runContext.ts";
 export declare const JsonPayload: import("arktype/internal/variants/object.ts").ObjectType<{
     "~pullfrog": true;
@@ -6,6 +6,7 @@ export declare const JsonPayload: import("arktype/internal/variants/object.ts").
     prompt: string;
     model?: string | undefined;
     modelExplicit?: boolean | undefined;
+    effort?: string | number | undefined;
     triggerer?: string | undefined;
     baseInstructions?: string | undefined;
     eventInstructions?: string;
@@ -31,6 +32,7 @@ export declare const Inputs: import("arktype/internal/variants/object.ts").Objec
     prompt?: string | undefined;
     prompt_file?: string | undefined;
     model?: string | undefined;
+    effort?: string | undefined;
     timeout?: string | undefined;
     push?: "disabled" | "enabled" | "restricted" | undefined;
     shell?: "disabled" | "enabled" | "restricted" | undefined;
@@ -53,6 +55,7 @@ export declare function resolvePayload(resolvedPromptInput: ResolvedPromptInput,
     version: string;
     model: string | undefined;
     modelExplicit: boolean;
+    effort: number | undefined;
     prompt: string;
     triggerer: string | undefined;
     baseInstructions: string | undefined;