pullfrog 0.1.30 → 0.1.31

package/dist/internal/index.d.ts

@@ -2,8 +2,8 @@
  * Internal entrypoint for the root app.
  * Re-exports shared types, values, and utilities needed by the Next.js app.
  */
-export type { AuthorPermission, ModelAlias, ModelProvider, Payload, PayloadEvent, ProviderConfig, PushPermission, ShellPermission, ToolPermission, WriteablePayload, } from "../external.ts";
-export { DEFAULT_PROXY_MODEL, getAutoSelectHintModel, getModelEnvVars, getModelManagedCredentials, getModelProvider, getProviderDisplayName, modelAliases, parseModel, providers, pullfrogMcpName, resolveCliModel, resolveDisplayAlias, resolveModelSlug, resolveOpenRouterModel, } from "../external.ts";
+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 { Mode } from "../modes.ts";
 export { modes } from "../modes.ts";
 export type { BuildPullfrogFooterParams, WorkflowRunFooterInfo, } from "../utils/buildPullfrogFooter.ts";

package/dist/internal.js

@@ -9,20 +9,22 @@ var providers = {
     displayName: "Anthropic",
     envVars: ["ANTHROPIC_API_KEY", "CLAUDE_CODE_OAUTH_TOKEN"],
     models: {
-      // OpenRouter serves claude-fable-5, but models.dev's OpenRouter mirror
-      // hasn't indexed it yet (shipped 2026-06-09), so the catalog drift gate
-      // can't validate an openRouterResolve. omit it until the mirror catches
-      // up; direct BYOK / Claude Code resolves anthropic/claude-fable-5 fine.
+      // claude-fable-5 is disabled globally — access has been revoked, so it
+      // can't run as-is anywhere (BYOK, Claude Code, or Router). the fallback
+      // redirects all resolution to opus and hides it from pickers; opus is the
+      // universally-available flagship, the AUTO_INTELLIGENT tier target, and
+      // the recommended pick. clear the fallback if fable access returns (#959).
       "claude-fable": {
         displayName: "Claude Fable",
         resolve: "anthropic/claude-fable-5",
-        preferred: true,
+        fallback: "anthropic/claude-opus",
         subagentModel: "claude-sonnet"
       },
       "claude-opus": {
         displayName: "Claude Opus",
         resolve: "anthropic/claude-opus-4-8",
         openRouterResolve: "openrouter/anthropic/claude-opus-4.8",
+        preferred: true,
         subagentModel: "claude-sonnet"
       },
       "claude-sonnet": {
@@ -181,8 +183,8 @@ var providers = {
     models: {
       "kimi-k2": {
         displayName: "Kimi K2",
-        resolve: "moonshotai/kimi-k2.6",
-        openRouterResolve: "openrouter/moonshotai/kimi-k2.6",
+        resolve: "moonshotai/kimi-k2.7-code",
+        openRouterResolve: "openrouter/moonshotai/kimi-k2.7-code",
         preferred: true
       }
     }
@@ -264,8 +266,10 @@ var providers = {
       },
       "kimi-k2": {
         displayName: "Kimi K2",
+        // opencode Zen serves only up to k2.6; the OpenRouter fallback (used for
+        // router/oss proxy runs) takes the newer k2.7-code.
         resolve: "opencode/kimi-k2.6",
-        openRouterResolve: "openrouter/moonshotai/kimi-k2.6"
+        openRouterResolve: "openrouter/moonshotai/kimi-k2.7-code"
       },
       "minimax-m2.5": {
         displayName: "MiniMax M2",
@@ -300,9 +304,14 @@ var providers = {
     models: {
       "glm-5.1": {
         displayName: "GLM 5.1",
-        resolve: "opencode-go/glm-5.1",
-        openRouterResolve: "openrouter/z-ai/glm-5.1",
+        resolve: "opencode-go/glm-5.2",
+        openRouterResolve: "openrouter/z-ai/glm-5.2",
         preferred: true
+      },
+      "kimi-k2": {
+        displayName: "Kimi K2",
+        resolve: "opencode-go/kimi-k2.7-code",
+        openRouterResolve: "openrouter/moonshotai/kimi-k2.7-code"
       }
     }
   }),
@@ -438,8 +447,8 @@ var providers = {
       },
       "kimi-k2": {
         displayName: "Kimi K2",
-        resolve: "openrouter/moonshotai/kimi-k2.6",
-        openRouterResolve: "openrouter/moonshotai/kimi-k2.6"
+        resolve: "openrouter/moonshotai/kimi-k2.7-code",
+        openRouterResolve: "openrouter/moonshotai/kimi-k2.7-code"
       },
       "minimax-m2.5": {
         displayName: "MiniMax M2",
@@ -498,21 +507,31 @@ var modelAliases = Object.entries(providers).flatMap(
     hidden: def.hidden ?? false
   }))
 );
-var defaultProxyAlias = modelAliases.find((a) => a.slug === "deepseek/deepseek-pro");
-if (!defaultProxyAlias?.openRouterResolve) {
-  throw new Error("DEFAULT_PROXY_MODEL: deepseek/deepseek-pro missing openRouterResolve");
+var AUTO_EFFICIENT = "auto/efficient";
+var AUTO_INTELLIGENT = "auto/intelligent";
+var AUTO_TIER_TARGET = {
+  [AUTO_EFFICIENT]: "moonshotai/kimi-k2",
+  [AUTO_INTELLIGENT]: "anthropic/claude-opus"
+};
+function isAutoTier(slug) {
+  return slug === AUTO_EFFICIENT || slug === AUTO_INTELLIGENT;
 }
-var DEFAULT_PROXY_MODEL = defaultProxyAlias.openRouterResolve;
-var defaultProxyDisplayName = defaultProxyAlias.displayName;
-function getAutoSelectHintModel() {
-  return defaultProxyDisplayName;
+function defaultAutoTier(hasCard) {
+  return hasCard ? AUTO_INTELLIGENT : AUTO_EFFICIENT;
+}
+function resolveAutoTier(params) {
+  if (!params.hasCard) return AUTO_EFFICIENT;
+  return isAutoTier(params.model) ? params.model : defaultAutoTier(params.hasCard);
+}
+function isCardGatedModel(slug) {
+  return resolveOpenRouterModel(slug) !== void 0;
 }
 function resolveModelSlug(slug) {
   return modelAliases.find((a) => a.slug === slug)?.resolve;
 }
 var MAX_FALLBACK_DEPTH = 10;
 function resolveDisplayAlias(slug) {
-  let current = slug;
+  let current = isAutoTier(slug) ? AUTO_TIER_TARGET[slug] : slug;
   const visited = /* @__PURE__ */ new Set();
   for (let i = 0; i < MAX_FALLBACK_DEPTH; i++) {
     if (visited.has(current)) return void 0;
@@ -530,6 +549,15 @@ function resolveCliModel(slug) {
 function resolveOpenRouterModel(slug) {
   return resolveDisplayAlias(slug)?.openRouterResolve;
 }
+var defaultProxyAlias = resolveDisplayAlias(AUTO_EFFICIENT);
+if (!defaultProxyAlias?.openRouterResolve) {
+  throw new Error(`DEFAULT_PROXY_MODEL: ${AUTO_EFFICIENT} has no openRouterResolve`);
+}
+var DEFAULT_PROXY_MODEL = defaultProxyAlias.openRouterResolve;
+var defaultProxyDisplayName = defaultProxyAlias.displayName;
+function getAutoSelectHintModel() {
+  return defaultProxyDisplayName;
+}
 
 // external.ts
 var pullfrogMcpName = "pullfrog";
@@ -1135,6 +1163,15 @@ var modes = computeModes("opencode");
 // 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>`;
+function providerDisplayName(slug) {
+  try {
+    const key = getModelProvider(slug);
+    const meta = providers[key];
+    return meta?.displayName ?? key;
+  } catch {
+    return slug;
+  }
+}
 function formatModelLabel(params) {
   const alias = resolveDisplayAlias(params.model) ?? // reverse-lookup: when the caller passes an effective model (proxy or
   // resolved target like "openrouter/anthropic/claude-opus-4.7") instead of
@@ -1145,10 +1182,26 @@ function formatModelLabel(params) {
   if (params.oss) {
     return `\`${displayName}\` (free via [Pullfrog for OSS](https://pullfrog.com/for-oss))`;
   }
-  return alias?.isFree ? `\`${displayName}\` (free)` : `\`${displayName}\``;
+  const base = alias?.isFree ? `\`${displayName}\` (free)` : `\`${displayName}\``;
+  if (params.fallbackFrom) {
+    return `${base} (credentials for ${providerDisplayName(params.fallbackFrom)} not configured)`;
+  }
+  if (params.clamped) {
+    const target = isAutoTier(params.clamped.from) ? "the intelligent tier" : `\`${resolveDisplayAlias(params.clamped.from)?.displayName ?? params.clamped.from}\``;
+    return params.clamped.reason === "card" ? `${base} (${target} needs a [card on file](https://docs.pullfrog.com/models))` : `${base} (${target} needs a [provider key](https://docs.pullfrog.com/models) \u2014 no Router support yet)`;
+  }
+  if (params.unselectedProxyDefault) {
+    return `${base} (default \u2014 [pick a model](https://docs.pullfrog.com/models) for stronger reviews)`;
+  }
+  return base;
 }
 function buildPullfrogFooter(params) {
   const parts = [];
+  if (params.shaPinned) {
+    parts.push(
+      "\u26A0\uFE0F this action is pinned to a commit SHA, which [freezes the cleanup step](https://docs.pullfrog.com/versioning) \u2014 switch to `@v0` or keep the SHA fresh with Dependabot"
+    );
+  }
   if (params.customParts) {
     parts.push(...params.customParts);
   }
@@ -1163,7 +1216,15 @@ function buildPullfrogFooter(params) {
     parts.push("via [Pullfrog](https://pullfrog.com)");
   }
   if (params.model) {
-    parts.push(`Using ${formatModelLabel({ model: params.model, oss: params.oss })}`);
+    parts.push(
+      `Using ${formatModelLabel({
+        model: params.model,
+        fallbackFrom: params.fallbackFrom,
+        clamped: params.clamped,
+        unselectedProxyDefault: params.unselectedProxyDefault,
+        oss: params.oss
+      })}`
+    );
   }
   const allParts = [...parts, "[\u{1D54F}](https://x.com/pullfrogai)"];
   return `
@@ -1397,6 +1458,8 @@ function isValidTimeString(input) {
   return parseTimeString(input) !== null;
 }
 export {
+  AUTO_EFFICIENT,
+  AUTO_INTELLIGENT,
   DEFAULT_PROXY_MODEL,
   LEAPING_INTO_ACTION_PREFIX,
   MAX_LEARNINGS_LENGTH,
@@ -1406,6 +1469,7 @@ export {
   buildPullfrogFooter,
   createLeapingProgressComment,
   decodeJwtExpMs,
+  defaultAutoTier,
   deleteProgressCommentApi,
   getAutoSelectHintModel,
   getModelEnvVars,
@@ -1413,6 +1477,8 @@ export {
   getModelProvider,
   getProgressComment,
   getProviderDisplayName,
+  isAutoTier,
+  isCardGatedModel,
   isLeapingIntoActionCommentBody,
   isValidTimeString,
   modelAliases,
@@ -1423,6 +1489,7 @@ export {
   providers,
   pullfrogMcpName,
   refreshCodexAuthBody,
+  resolveAutoTier,
   resolveCliModel,
   resolveDisplayAlias,
   resolveModelSlug,

package/dist/mcp/checkSuite.d.ts

@@ -6,4 +6,6 @@ export declare function GetCheckSuiteLogsTool(ctx: ToolContext): import("fastmcp
     check_suite_id: number;
 }, {
     check_suite_id: number;
-}>>;
+}>> & {
+    mutates?: boolean;
+};

package/dist/mcp/checkout.d.ts

@@ -64,7 +64,7 @@ type CheckoutPrBranchParams = GitContext & {
 /**
  * Shared helper to checkout a PR branch and configure fork remotes.
  * Assumes origin remote is already configured with authentication.
- * Updates toolState.issueNumber, toolState.checkoutSha, and toolState.pushUrl (for fork PRs).
+ * Updates the primary repo state's issueNumber, checkoutSha, and pushUrl (for fork PRs).
  */
 export declare function checkoutPrBranch(pr: PrData, params: CheckoutPrBranchParams): Promise<{
     hookWarning?: string | undefined;
@@ -73,5 +73,7 @@ export declare function CheckoutPrTool(ctx: ToolContext): import("fastmcp").Tool
     pull_number: number;
 }, {
     pull_number: number;
-}>>;
+}>> & {
+    mutates?: boolean;
+};
 export {};

package/dist/mcp/comment.d.ts

@@ -14,7 +14,9 @@ export declare function CreateCommentTool(ctx: ToolContext): import("fastmcp").T
     issueNumber: number;
     body: string;
     type?: "Plan" | "Comment";
-}>>;
+}>> & {
+    mutates?: boolean;
+};
 export declare const EditComment: import("arktype/internal/variants/object.ts").ObjectType<{
     commentId: number;
     body: string;
@@ -25,7 +27,9 @@ export declare function EditCommentTool(ctx: ToolContext): import("fastmcp").Too
 }, {
     commentId: number;
     body: string;
-}>>;
+}>> & {
+    mutates?: boolean;
+};
 export declare const ReportProgress: import("arktype/internal/variants/object.ts").ObjectType<{
     body: string;
     target_plan_comment?: boolean;
@@ -60,7 +64,9 @@ export declare function ReportProgressTool(ctx: ToolContext): import("fastmcp").
 }, {
     body: string;
     target_plan_comment?: boolean;
-}>>;
+}>> & {
+    mutates?: boolean;
+};
 /**
  * Delete the progress comment if it exists.
  * Used by main.ts for stranded-comment cleanup (orphaned "Leaping into action" or
@@ -116,4 +122,6 @@ export declare function ReplyToReviewCommentTool(ctx: ToolContext): import("fast
     pull_number: number;
     comment_id: number;
     body: string;
-}>>;
+}>> & {
+    mutates?: boolean;
+};

package/dist/mcp/commitInfo.d.ts

@@ -6,4 +6,6 @@ export declare function CommitInfoTool(ctx: ToolContext): import("fastmcp").Tool
     sha: string;
 }, {
     sha: string;
-}>>;
+}>> & {
+    mutates?: boolean;
+};

package/dist/mcp/dependencies.d.ts

@@ -4,5 +4,9 @@ import type { ToolContext } from "./server.ts";
  * called eagerly from main.ts at startup and also available via MCP tools.
  */
 export declare function startInstallation(ctx: ToolContext): void;
-export declare function StartDependencyInstallationTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<object, object>>;
-export declare function AwaitDependencyInstallationTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<object, object>>;
+export declare function StartDependencyInstallationTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<object, object>> & {
+    mutates?: boolean;
+};
+export declare function AwaitDependencyInstallationTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<object, object>> & {
+    mutates?: boolean;
+};

package/dist/mcp/git.d.ts

@@ -5,49 +5,68 @@ export declare function validateTagName(tag: string): void;
 export declare const PushBranch: import("arktype/internal/variants/object.ts").ObjectType<{
     force: import("arktype/internal/attributes.ts").Default<boolean, false>;
     branchName?: string;
+    repo?: string;
 }, {}>;
-export type PushErrorKind = "concurrent-push" | "transient" | "unknown";
+export type PushErrorKind = "concurrent-push" | "transient" | "transient-auth" | "unknown";
 export declare function classifyPushError(msg: string): PushErrorKind;
 export declare function PushBranchTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
     branchName?: string;
+    repo?: string;
     force?: boolean;
 }, {
     branchName?: string;
+    repo?: string;
     force?: boolean;
-}>>;
+}>> & {
+    mutates?: boolean;
+};
 export declare function CommitChangesTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
     message: string;
     files?: string[];
 }, {
     message: string;
     files?: string[];
-}>>;
+}>> & {
+    mutates?: boolean;
+};
 export declare const AUTH_REQUIRED_REDIRECT: Record<string, string>;
 export declare const NOSHELL_BLOCKED_SUBCOMMANDS: Record<string, string>;
 export declare const NOSHELL_BLOCKED_ARGS: string[];
 export declare function GitTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
     command: string;
     args?: string[];
+    repo?: string;
 }, {
     command: string;
     args?: string[];
-}>>;
+    repo?: string;
+}>> & {
+    mutates?: boolean;
+};
 export declare function GitFetchTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
     ref: string;
     depth?: number;
+    repo?: string;
 }, {
     ref: string;
     depth?: number;
-}>>;
+    repo?: string;
+}>> & {
+    mutates?: boolean;
+};
 export declare function DeleteBranchTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
     branchName: string;
 }, {
     branchName: string;
-}>>;
+}>> & {
+    mutates?: boolean;
+};
 export declare function PushTagsTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
     tag: string;
     force?: boolean;
 }, {
     tag: string;
     force?: boolean;
-}>>;
+}>> & {
+    mutates?: boolean;
+};

package/dist/mcp/issue.d.ts

@@ -15,4 +15,29 @@ export declare function IssueTool(ctx: ToolContext): import("fastmcp").Tool<any,
     body: string;
     labels?: string[];
     assignees?: string[];
-}>>;
+}>> & {
+    mutates?: boolean;
+};
+export declare const CloseIssue: import("arktype/internal/variants/object.ts").ObjectType<{
+    issue_number: number;
+    state_reason: "completed" | "not_planned" | "duplicate";
+}, {}>;
+export declare function CloseIssueTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    issue_number: number;
+    state_reason: "completed" | "not_planned" | "duplicate";
+}, {
+    issue_number: number;
+    state_reason: "completed" | "not_planned" | "duplicate";
+}>> & {
+    mutates?: boolean;
+};
+export declare const ReopenIssue: import("arktype/internal/variants/object.ts").ObjectType<{
+    issue_number: number;
+}, {}>;
+export declare function ReopenIssueTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    issue_number: number;
+}, {
+    issue_number: number;
+}>> & {
+    mutates?: boolean;
+};

package/dist/mcp/issueComments.d.ts

@@ -6,4 +6,6 @@ export declare function GetIssueCommentsTool(ctx: ToolContext): import("fastmcp"
     issue_number: number;
 }, {
     issue_number: number;
-}>>;
+}>> & {
+    mutates?: boolean;
+};

package/dist/mcp/issueEvents.d.ts

@@ -6,4 +6,6 @@ export declare function GetIssueEventsTool(ctx: ToolContext): import("fastmcp").
     issue_number: number;
 }, {
     issue_number: number;
-}>>;
+}>> & {
+    mutates?: boolean;
+};

package/dist/mcp/issueInfo.d.ts

@@ -6,4 +6,6 @@ export declare function IssueInfoTool(ctx: ToolContext): import("fastmcp").Tool<
     issue_number: number;
 }, {
     issue_number: number;
-}>>;
+}>> & {
+    mutates?: boolean;
+};

package/dist/mcp/labels.d.ts

@@ -9,4 +9,19 @@ export declare function AddLabelsTool(ctx: ToolContext): import("fastmcp").Tool<
 }, {
     issue_number: number;
     labels: string[];
-}>>;
+}>> & {
+    mutates?: boolean;
+};
+export declare const RemoveLabelsParams: import("arktype/internal/variants/object.ts").ObjectType<{
+    issue_number: number;
+    labels: string[];
+}, {}>;
+export declare function RemoveLabelsTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    issue_number: number;
+    labels: string[];
+}, {
+    issue_number: number;
+    labels: string[];
+}>> & {
+    mutates?: boolean;
+};

package/dist/mcp/output.d.ts

@@ -4,9 +4,13 @@ export declare const SetOutputParams: import("arktype/internal/variants/object.t
     value: string;
 }, {}>;
 type JsonSchema = Record<string, unknown>;
-export declare function SetOutputTool(ctx: ToolContext, outputSchema?: JsonSchema): import("fastmcp").Tool<any, StandardSchemaV1<any, any>> | import("fastmcp").Tool<any, StandardSchemaV1<{
+export declare function SetOutputTool(ctx: ToolContext, outputSchema?: JsonSchema): (import("fastmcp").Tool<any, StandardSchemaV1<any, any>> & {
+    mutates?: boolean;
+}) | (import("fastmcp").Tool<any, StandardSchemaV1<{
     value: string;
 }, {
     value: string;
-}>>;
+}>> & {
+    mutates?: boolean;
+});
 export {};

package/dist/mcp/pr.d.ts

@@ -4,7 +4,18 @@ export declare const PullRequest: import("arktype/internal/variants/object.ts").
     body: string;
     base: string;
     draft?: boolean;
+    repo?: string;
 }, {}>;
+export declare const ClosePullRequest: import("arktype/internal/variants/object.ts").ObjectType<{
+    pull_number: number;
+}, {}>;
+export declare function ClosePullRequestTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    pull_number: number;
+}, {
+    pull_number: number;
+}>> & {
+    mutates?: boolean;
+};
 export declare const UpdatePullRequestBody: import("arktype/internal/variants/object.ts").ObjectType<{
     pull_number: number;
     body: string;
@@ -15,15 +26,21 @@ export declare function UpdatePullRequestBodyTool(ctx: ToolContext): import("fas
 }, {
     pull_number: number;
     body: string;
-}>>;
+}>> & {
+    mutates?: boolean;
+};
 export declare function CreatePullRequestTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
     title: string;
     body: string;
     base: string;
     draft?: boolean;
+    repo?: string;
 }, {
     title: string;
     body: string;
     base: string;
     draft?: boolean;
-}>>;
+    repo?: string;
+}>> & {
+    mutates?: boolean;
+};

package/dist/mcp/prInfo.d.ts

@@ -6,4 +6,6 @@ export declare function PullRequestInfoTool(ctx: ToolContext): import("fastmcp")
     pull_number: number;
 }, {
     pull_number: number;
-}>>;
+}>> & {
+    mutates?: boolean;
+};

package/dist/mcp/resolveRepoCtx.d.ts

@@ -0,0 +1,34 @@
+import { type RepoAccess } from "../toolState.ts";
+import { type OctokitWithPlugins } from "../utils/github.ts";
+import type { ToolContext } from "./server.ts";
+/**
+ * per-repo execution context for a single tool call. resolved from the
+ * optional `repo` param (a bare repo name — owner-implicit, same account as
+ * the primary). carries the correct token tier + working directory so a tool
+ * can talk to GitHub and run git against the right checkout.
+ */
+export interface RepoCtx {
+    owner: string;
+    name: string;
+    /** working tree: primary = process.cwd(); secondary = ctx.tmpdir/xrepo/<name> */
+    dir: string;
+    access: RepoAccess;
+    /** octokit scoped to the repo's tier (write tokens for primary/write, read token for read) */
+    octokit: OctokitWithPlugins;
+    /** git token scoped to the repo's tier */
+    gitToken: string;
+    /** re-mint this tier's git token on an auth-class push failure (push retries) */
+    refreshGitToken: ((stale: string) => Promise<string>) | undefined;
+}
+/**
+ * resolve the execution context for a `repo`-scoped tool call.
+ *
+ * - omitted / primary name → the primary ctx (unchanged single-repo path).
+ * - a `write`-tier secondary → the same write-scoped tokens as the primary
+ *   (mcpToken + gitToken are minted over the write set ∪ primary).
+ * - a `read`-tier secondary → the contents:read token (clone-for-reference).
+ *
+ * throws when `repo` isn't a registered checkout — secondaries must be cloned
+ * via `checkout_repo` first, which is what populates `toolState.repos`.
+ */
+export declare function resolveRepoCtx(ctx: ToolContext, repo?: string | undefined): RepoCtx;

package/dist/mcp/review.d.ts

@@ -1,5 +1,5 @@
 import type { RestEndpointMethodTypes } from "@octokit/rest";
-import type { CommentableLines } from "../toolState.ts";
+import { type CommentableLines } from "../toolState.ts";
 import type { ToolContext } from "./server.ts";
 export type { CommentableLines };
 /**
@@ -69,7 +69,7 @@ export type DuplicateReviewDecision = {
  * adds noise to the PR.
  *
  * legitimate follow-up reviews after new commits ARE allowed: the
- * new-commits-mid-review path advances toolState.checkoutSha past the
+ * new-commits-mid-review path advances the primary repo state's checkoutSha past the
  * previously reviewed sha, and a subsequent checkout_pr advances it again.
  * any call where checkoutSha has moved past the prior reviewedSha is a real
  * follow-up and goes through. anything else — same sha, or no checkoutSha
@@ -103,6 +103,7 @@ export declare function duplicateReviewDecision(params: {
  */
 export declare function reviewSkipDecision(params: {
     approved: boolean;
+    requestChanges?: boolean;
     body: string | null | undefined;
     hasComments: boolean;
     prApproveEnabled: boolean;
@@ -112,6 +113,7 @@ export declare const CreatePullRequestReview: import("arktype/internal/variants/
     pull_number: number;
     body?: string;
     approved?: boolean;
+    request_changes?: boolean;
     commit_id?: string;
     comments?: {
         path: string;
@@ -126,6 +128,7 @@ export declare function CreatePullRequestReviewTool(ctx: ToolContext): import("f
     pull_number: number;
     body?: string;
     approved?: boolean;
+    request_changes?: boolean;
     commit_id?: string;
     comments?: {
         path: string;
@@ -139,6 +142,7 @@ export declare function CreatePullRequestReviewTool(ctx: ToolContext): import("f
     pull_number: number;
     body?: string;
     approved?: boolean;
+    request_changes?: boolean;
     commit_id?: string;
     comments?: {
         path: string;
@@ -148,7 +152,9 @@ export declare function CreatePullRequestReviewTool(ctx: ToolContext): import("f
         suggestion?: string;
         start_line?: number;
     }[];
-}>>;
+}>> & {
+    mutates?: boolean;
+};
 /**
  * clear a pending review draft stranded on the PR by a prior hard-killed run
  * (workflow timeout, OOM) so the next createReview can succeed.