pullfrog 0.1.46 → 0.1.48

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";
@@ -15,4 +16,6 @@ export { isLeapingIntoActionCommentBody, LEAPING_INTO_ACTION_PREFIX, } from "../
 export { MAX_LEARNINGS_LENGTH, truncateAtLineBoundary } from "../utils/learningsTruncate.ts";
 export type { CreateProgressCommentTarget, ProgressComment, ProgressCommentType, } from "../utils/progressComment.ts";
 export { createLeapingProgressComment, deleteProgressCommentApi, getProgressComment, updateProgressComment, } from "../utils/progressComment.ts";
+export type { RunStatusCheckConclusion, RunStatusCheckOctokit, } from "../utils/runStatusCheck.ts";
+export { APPROVAL_CHECK_NAME, createRunStatusCheck, finalizeRunStatusCheck, RUN_STATUS_CHECK_NAME, runStatusCheckNeedsFinalizing, } from "../utils/runStatusCheck.ts";
 export { isValidTimeString, parseTimeString, TIMEOUT_DISABLED, } from "../utils/time.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.75;
+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>`;
@@ -1329,6 +1455,113 @@ async function createLeapingProgressComment(ctx, target, body) {
   };
 }
 
+// utils/runStatusCheck.ts
+var RUN_STATUS_CHECK_NAME = "Pullfrog";
+var APPROVAL_CHECK_NAME = "Pullfrog approval";
+var IN_PROGRESS_OUTPUT = {
+  title: "Pullfrog is running",
+  summary: "Pullfrog is working on this pull request. This check updates when the run finishes."
+};
+function disableCheckLine(owner, repo) {
+  const url = `https://pullfrog.com/console/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}#auto-review-prs`;
+  return `
+
+[Turn off this check \u2192](${url}) \u2014 it reports run status only and gates nothing unless you required it in branch protection.`;
+}
+var TERMINAL_OUTPUT = {
+  success: {
+    title: "Pullfrog run completed",
+    summary: "The Pullfrog run finished successfully."
+  },
+  failure: {
+    title: "Pullfrog run failed",
+    summary: "The Pullfrog run failed. See the run logs for details."
+  },
+  cancelled: {
+    title: "Pullfrog run cancelled",
+    summary: "The Pullfrog run was cancelled before it finished."
+  },
+  timed_out: {
+    title: "Pullfrog run timed out",
+    summary: "The Pullfrog run exceeded its timeout. See the run logs for details."
+  },
+  action_required: {
+    title: "Pullfrog run needs attention",
+    summary: "The Pullfrog run stopped and needs attention. See the run logs for details."
+  },
+  neutral: {
+    title: "Pullfrog run finished",
+    summary: "The Pullfrog run finished without a pass or fail outcome."
+  },
+  skipped: {
+    title: "Pullfrog run skipped",
+    summary: "This run was superseded by another Pullfrog run."
+  },
+  stale: {
+    title: "Pullfrog run didn't finish",
+    summary: "Pullfrog never received a completion signal for this run. See the run logs for details."
+  }
+};
+function terminalOutput(params) {
+  const base = TERMINAL_OUTPUT[params.conclusion];
+  const review = params.reviewUrl ? `
+
+[View the review Pullfrog posted \u2192](${params.reviewUrl})` : "";
+  const disable = params.conclusion === "success" ? "" : disableCheckLine(params.owner, params.repo);
+  return { title: base.title, summary: base.summary + review + disable };
+}
+async function createRunStatusCheck(params) {
+  const existing = await params.octokit.rest.checks.listForRef({
+    owner: params.owner,
+    repo: params.repo,
+    ref: params.headSha,
+    check_name: RUN_STATUS_CHECK_NAME,
+    status: "in_progress"
+  }).catch(() => void 0);
+  const reusable = existing?.data.check_runs[0];
+  if (reusable) return reusable.id;
+  const createParams = {
+    owner: params.owner,
+    repo: params.repo,
+    name: RUN_STATUS_CHECK_NAME,
+    head_sha: params.headSha,
+    status: "in_progress",
+    output: IN_PROGRESS_OUTPUT
+  };
+  if (params.detailsUrl) createParams.details_url = params.detailsUrl;
+  const created = await params.octokit.rest.checks.create(createParams);
+  return created.data.id;
+}
+async function finalizeRunStatusCheck(params) {
+  const updateParams = {
+    owner: params.owner,
+    repo: params.repo,
+    check_run_id: params.checkRunId,
+    status: "completed",
+    conclusion: params.conclusion,
+    output: terminalOutput({
+      conclusion: params.conclusion,
+      owner: params.owner,
+      repo: params.repo,
+      reviewUrl: params.reviewUrl
+    })
+  };
+  if (params.detailsUrl) updateParams.details_url = params.detailsUrl;
+  await params.octokit.rest.checks.update(updateParams);
+}
+async function runStatusCheckNeedsFinalizing(params) {
+  try {
+    const existing = await params.octokit.rest.checks.get({
+      owner: params.owner,
+      repo: params.repo,
+      check_run_id: params.checkRunId
+    });
+    return existing.data.status !== "completed";
+  } catch {
+    return false;
+  }
+}
+
 // utils/time.ts
 var TIMEOUT_DISABLED = "none";
 var TIME_STRING_REGEX = /^(?:(\d+)h)?(?:(\d+)m)?(?:(\d+)s)?$/;
@@ -1344,20 +1577,28 @@ function isValidTimeString(input) {
   return parseTimeString(input) !== null;
 }
 export {
+  APPROVAL_CHECK_NAME,
   AUTO_EFFICIENT,
   AUTO_INTELLIGENT,
+  DEFAULT_EFFORT_POSITION,
   DEFAULT_PROXY_MODEL,
+  EFFORT_ALIASES,
   LEAPING_INTO_ACTION_PREFIX,
   MAX_LEARNINGS_LENGTH,
   OAuthInvalidGrantError,
   PULLFROG_DIVIDER,
+  RUN_STATUS_CHECK_NAME,
   TIMEOUT_DISABLED,
   buildPullfrogFooter,
+  commercialPaywallBody,
   createLeapingProgressComment,
+  createRunStatusCheck,
   decodeJwtExpMs,
   defaultAutoTier,
   deleteProgressCommentApi,
+  finalizeRunStatusCheck,
   getAutoSelectHintModel,
+  getModelEffortLevels,
   getModelEnvVars,
   getModelManagedCredentials,
   getModelProvider,
@@ -1365,11 +1606,14 @@ export {
   getProviderDisplayName,
   isAutoTier,
   isCardGatedModel,
+  isEffortPosition,
   isLeapingIntoActionCommentBody,
   isValidTimeString,
   modelAliases,
   modes,
+  offeredRungs,
   parseCodexAuthBody,
+  parseEffortPosition,
   parseModel,
   parseTimeString,
   providers,
@@ -1378,8 +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/toolState.d.ts

@@ -104,6 +104,7 @@ export interface ToolState {
     approval?: {
         wouldApprove: boolean;
         sha: string | undefined;
+        url?: string | undefined;
     };
     reviewReplies?: Map<number, {
         commentId: number;