pullfrog 0.1.104 → 0.1.106

package/dist/external.d.ts

@@ -375,8 +375,9 @@ export interface WriteablePayload {
 export type Payload = Readonly<WriteablePayload>;
 /**
  * Whether `find_similar_issues` is registered for this run: an entitled account,
- * on an issue rather than a PR. Shared by the MCP registration and the prompt so
- * the duplicate-detection instructions can never describe an absent tool.
+ * on an issue or a run with no target (`pullfrog run "enrich issue #42"`), never a PR.
+ * Shared by the MCP registration and the prompt so the duplicate-detection
+ * instructions can never describe an absent tool.
  */
 export declare function hasSimilarIssues(params: {
     repoIntelligence: boolean;

package/dist/index.js

@@ -109939,9 +109939,34 @@ var AZURE_USE_CHAT_COMPLETIONS_ENV = "AZURE_USE_CHAT_COMPLETIONS";
 var OPENAI_COMPATIBLE_PROVIDER = "openai-compatible";
 var OPENAI_COMPATIBLE_BASE_URL_ENV = "OPENAI_COMPATIBLE_BASE_URL";
 var OPENAI_COMPATIBLE_API_KEY_ENV = "OPENAI_COMPATIBLE_API_KEY";
-var OPENAI_COMPATIBLE_MODEL_ENV = "OPENAI_COMPATIBLE_MODEL";
 var OPENAI_COMPATIBLE_CONTEXT_ENV = "OPENAI_COMPATIBLE_CONTEXT";
 var OPENAI_COMPATIBLE_MAX_OUTPUT_ENV = "OPENAI_COMPATIBLE_MAX_OUTPUT";
+function isOpenAICompatibleSetName(name) {
+  return name !== "byok" && name.length <= 32 && /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name);
+}
+function openAICompatibleSetName(slug2) {
+  const prefix = `${OPENAI_COMPATIBLE_PROVIDER}/`;
+  if (!slug2.startsWith(prefix)) return void 0;
+  const name = slug2.slice(prefix.length);
+  return isOpenAICompatibleSetName(name) ? name : void 0;
+}
+var OPENAI_COMPATIBLE_FIELDS = [
+  "baseUrl",
+  "apiKey",
+  "model",
+  "context",
+  "maxOutput"
+];
+function openAICompatibleEnv(name) {
+  const prefix = `OPENAI_COMPATIBLE_${name ? `${name.toUpperCase().replaceAll("-", "_")}_` : ""}`;
+  return {
+    baseUrl: `${prefix}BASE_URL`,
+    apiKey: `${prefix}API_KEY`,
+    model: `${prefix}MODEL`,
+    context: `${prefix}CONTEXT`,
+    maxOutput: `${prefix}MAX_OUTPUT`
+  };
+}
 var PROVIDER_GATEWAY_URL_ENV = {
   anthropic: "ANTHROPIC_BASE_URL",
   openai: "OPENAI_BASE_URL"
@@ -109986,7 +110011,7 @@ function findDanglingPromptToolRefs(params) {
   return [...new Set(extractMcpToolRefs(params.agentId, params.prompt))].filter((name) => !registered.has(name)).sort();
 }
 function hasSimilarIssues(params) {
-  return params.repoIntelligence && !!params.event.issue_number && !params.event.is_pr;
+  return params.repoIntelligence && !params.event.is_pr;
 }
 
 // utils/activity.ts
@@ -111814,7 +111839,7 @@ import { chmodSync, createWriteStream, existsSync as existsSync3, mkdirSync } fr
 import { join } from "node:path";
 import { pipeline } from "node:stream/promises";
 function resolveNpm() {
-  const npmCli = process.env.npm_execpath;
+  const npmCli = process.env.NPM_EXECPATH;
   if (npmCli?.endsWith("npm-cli.js")) return { command: process.execPath, args: [npmCli] };
   return { command: "npm", args: [] };
 }
@@ -112115,7 +112140,11 @@ function resolveRunEffort(ctx) {
   const configured = ctx.payload.effort !== void 0;
   const position = ctx.payload.effort ?? DEFAULT_EFFORT_POSITION;
   const alias = resolveRunAlias(ctx);
-  if (!alias) return { position, configured, rung: void 0, alias: void 0 };
+  if (!alias) {
+    const declarable = configured && !ctx.resolvedModel?.startsWith(`${AZURE_PROVIDER}/`);
+    const rung = declarable && ctx.declaredVariants ? resolveRung({ position, published: ctx.declaredVariants }) : void 0;
+    return { position, configured, rung, alias: void 0, declarable };
+  }
   return {
     position,
     configured,
@@ -112124,7 +112153,8 @@ function resolveRunEffort(ctx) {
       position,
       useOpenRouter: !!ctx.payload.proxyModel
     }),
-    alias
+    alias,
+    declarable: false
   };
 }
 
@@ -112141,7 +112171,7 @@ var import_semver = __toESM(require_semver2(), 1);
 // package.json
 var package_default = {
   name: "pullfrog",
-  version: "0.1.104",
+  version: "0.1.106",
   cliContractVersion: "1",
   type: "module",
   bin: {
@@ -124270,6 +124300,17 @@ function parseModel2(value2) {
   if (slash <= 0) return void 0;
   return { providerID: value2.slice(0, slash), modelID: value2.slice(slash + 1) };
 }
+async function resolveDeclaredRung(ctx, params) {
+  const resp = await params.client.config.providers();
+  const provider2 = resp.data?.providers.find((p) => p.id === params.model.providerID);
+  const variants = provider2?.models[params.model.modelID]?.variants ?? {};
+  const name = `${params.model.providerID}/${params.model.modelID}`;
+  const rung = resolveRunEffort({ ...ctx, declaredVariants: Object.keys(variants) }).rung;
+  log.info(
+    `\xBB effort: ${rung ? `${rung} (declared by opencode for ${name})` : `not applied \u2014 opencode declares no variants for ${name}`}`
+  );
+  return rung;
+}
 function bootOpencodeServer(params) {
   const logLevel = isDebugEnabled() ? "INFO" : "ERROR";
   if (logLevel !== "ERROR") log.info(`\xBB opencode log level: ${logLevel} (debug run)`);
@@ -124924,6 +124965,11 @@ var opencode = agent({
       log.info(`\xBB opencode session: ${sessionID}`);
       const labeler = new SessionLabeler();
       labeler.labelFor(sessionID);
+      const sdkModel = parseModel2(model);
+      const variant = effort.declarable && sdkModel ? await resolveDeclaredRung(
+        { ...ctx, resolvedModel: rawModel },
+        { client: client2, model: sdkModel }
+      ) : effort.rung;
       const runnerCtx = {
         client: client2,
         sessionID,
@@ -124932,7 +124978,7 @@ var opencode = agent({
         labeler,
         toolState: ctx.toolState,
         // `rawModel` folds in the auto-select pick — see the opencode.ts twin.
-        variant: effort.rung,
+        variant,
         todoTracker: ctx.todoTracker,
         onActivityTimeout: ctx.onActivityTimeout,
         onTurnRecovered: ctx.onTurnRecovered,
@@ -124994,7 +125040,6 @@ var opencode = agent({
         timeoutMs: AGENT_ACTIVITY_TIMEOUT_MS,
         abortTurn: () => turnController.abort()
       });
-      const sdkModel = parseModel2(model);
       let salvagesLeft = 1;
       const runTurn = async (text) => {
         const attempt = (prompt) => {
@@ -190132,14 +190177,15 @@ function computeIncrementalDiff(params) {
     const tips = [`origin/${params.baseBranch}`, ...params.formerBaseTips];
     const oldBase = versionBase({ sha: params.beforeSha, tips });
     const newBase = versionBase({ sha: params.headSha, tips });
+    const replayed = oldBase === newBase ? null : replay({ sha: params.beforeSha, from: oldBase, onto: newBase });
     const raw2 = $(
       "sh",
       [
         "-c",
         'git range-diff --no-color --creation-factor=1000 "$1..$(git commit-tree "$2^{tree}" -p "$1" -m x)" "$3..$(git commit-tree "$4^{tree}" -p "$3" -m x)"',
         "--",
-        oldBase,
-        params.beforeSha,
+        replayed ? newBase : oldBase,
+        replayed ?? params.beforeSha,
         newBase,
         params.headSha
       ],
@@ -190174,6 +190220,22 @@ function versionBase(params) {
   }
   return best.sha;
 }
+function replay(params) {
+  try {
+    return git([
+      "merge-tree",
+      "--write-tree",
+      `--merge-base=${params.from}`,
+      params.onto,
+      params.sha
+    ]);
+  } catch {
+    log.info(
+      `\xBB incremental diff: ${params.sha.slice(0, 7)} does not replay onto the new base; comparing each on its own`
+    );
+    return null;
+  }
+}
 function isDiffPrefix(ch) {
   return ch === " " || ch === "+" || ch === "-";
 }
@@ -196384,13 +196446,16 @@ function buildImplementPlanLink(ctx, issueNumber, commentId) {
   const apiUrl = getApiUrl();
   return `[Implement plan \u2794](${apiUrl}/trigger/${ctx.repo.owner}/${ctx.repo.name}/${issueNumber}?action=implement&comment_id=${commentId})`;
 }
-function buildEnrichmentLinks(ctx) {
+function runIssueNumber(ctx) {
+  return ctx.payload.event.issue_number ?? primaryRepoState(ctx.toolState).issueNumber;
+}
+function buildEnrichmentLinks(ctx, issueNumber) {
   const event = ctx.payload.event;
-  if (event.trigger !== "issues_opened" || event.is_pr || ctx.payload.prompt || ctx.toolState.selectedMode === "Build") {
-    return [];
-  }
+  const mode = ctx.toolState.selectedMode;
+  const enriching = mode === "Enrich" || event.trigger === "issues_opened" && !ctx.payload.prompt && mode !== "Build";
+  if (issueNumber === void 0 || event.is_pr || !enriching) return [];
   return [
-    `[Implement a fix \u2794](${getApiUrl()}/trigger/${ctx.repo.owner}/${ctx.repo.name}/${event.issue_number}?action=build)`
+    `[Implement a fix \u2794](${getApiUrl()}/trigger/${ctx.repo.owner}/${ctx.repo.name}/${issueNumber}?action=build)`
   ];
 }
 function addFooter(ctx, body) {
@@ -196426,10 +196491,11 @@ function CreateCommentTool(ctx) {
       });
       ctx.toolState.wasUpdated = true;
       log.info(`\xBB created comment ${result.data.id}`);
-      if (issueNumber === ctx.payload.event.issue_number) {
+      const ownTarget = issueNumber === runIssueNumber(ctx);
+      if (ownTarget) {
         ctx.toolState.standaloneCommentId = result.data.id;
       }
-      const enrichmentLinks = issueNumber === ctx.payload.event.issue_number ? buildEnrichmentLinks(ctx) : [];
+      const enrichmentLinks = ownTarget ? buildEnrichmentLinks(ctx, issueNumber) : [];
       if (commentType === "Plan" || enrichmentLinks.length > 0) {
         if (commentType === "Plan" && result.data.node_id) {
           await patchWorkflowRunFields(ctx, { planCommentNodeId: result.data.node_id });
@@ -196509,9 +196575,9 @@ async function reportProgress(ctx, params) {
   if (params.liveProgress && !ctx.payload.progressComments) {
     return { body, action: "skipped" };
   }
-  const issueNumber = ctx.payload.event.issue_number ?? primaryRepoState(ctx.toolState).issueNumber;
+  const issueNumber = runIssueNumber(ctx);
   const isPlanMode = ctx.toolState.selectedMode === "Plan";
-  const enrichmentLinks = params.liveProgress ? [] : buildEnrichmentLinks(ctx);
+  const enrichmentLinks = params.liveProgress ? [] : buildEnrichmentLinks(ctx, issueNumber);
   const apiCtx = { octokit: ctx.octokit, owner: ctx.repo.owner, repo: ctx.repo.name };
   if (target_plan_comment === true && ctx.toolState.existingPlanCommentId === void 0) {
     log.warning("target_plan_comment requested but no existingPlanCommentId in tool state");
@@ -197429,11 +197495,19 @@ import { execFileSync as execFileSync6, execSync as execSync2 } from "node:child
 import { mkdtempSync as mkdtempSync2, readdirSync, realpathSync as realpathSync2, rmSync as rmSync2, unlinkSync as unlinkSync2 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
 import { join as join15 } from "node:path";
+var TEMP_DIR_STATE = "temp_dir";
 function createTempDirectory() {
   const path4 = mkdtempSync2(join15(tmpdir2(), "pullfrog-"));
   process.env.PULLFROG_TEMP_DIR = path4;
   log.info(`\xBB created temp dir at ${path4}`);
-  return { path: path4, [Symbol.dispose]: () => removeTempDirectory(path4) };
+  const tracked = process.env.RUNNER_ENVIRONMENT !== "github-hosted";
+  if (tracked) saveSecretState(TEMP_DIR_STATE, path4);
+  return {
+    path: path4,
+    [Symbol.dispose]: () => {
+      if (removeTempDirectory(path4) && tracked) saveSecretState(TEMP_DIR_STATE, "");
+    }
+  };
 }
 function removeTempDirectory(path4) {
   try {
@@ -197444,10 +197518,12 @@ function removeTempDirectory(path4) {
       rmSync2(path4, { recursive: true, force: true });
     }
     log.debug(`\xBB removed temp dir at ${path4}`);
+    return true;
   } catch (err) {
     log.warning(
       `\xBB could not remove temp dir at ${path4}: ${err instanceof Error ? err.message : String(err)}`
     );
+    return false;
   }
 }
 function wipeRunnerLeakSurface() {
@@ -199522,7 +199598,7 @@ function GetIssueCommentsTool(ctx) {
     description: "Get all comments for a GitHub issue. Returns all comments including the issue body and all subsequent discussion comments. Example: `get_issue_comments({ issue_number: 1234 })`.",
     parameters: GetIssueComments,
     execute: execute(async ({ issue_number }) => {
-      primaryRepoState(ctx.toolState).issueNumber = issue_number;
+      primaryRepoState(ctx.toolState).issueNumber ??= issue_number;
       const comments = await ctx.octokit.paginate(ctx.octokit.rest.issues.listComments, {
         owner: ctx.repo.owner,
         repo: ctx.repo.name,
@@ -199560,7 +199636,7 @@ function GetIssueEventsTool(ctx) {
     description: "Get timeline events for a GitHub issue that aren't reflected in the current state. Returns cross-references to other issues/PRs and commit references. Note: current labels, assignees, state, and milestone are already available via get_issue.",
     parameters: GetIssueEvents,
     execute: execute(async ({ issue_number }) => {
-      primaryRepoState(ctx.toolState).issueNumber = issue_number;
+      primaryRepoState(ctx.toolState).issueNumber ??= issue_number;
       const events = await ctx.octokit.paginate(ctx.octokit.rest.issues.listEventsForTimeline, {
         owner: ctx.repo.owner,
         repo: ctx.repo.name,
@@ -199644,7 +199720,7 @@ function IssueInfoTool(ctx) {
         tmpdir: ctx.tmpdir,
         githubToken: ctx.githubInstallationToken
       });
-      primaryRepoState(ctx.toolState).issueNumber = issue_number;
+      primaryRepoState(ctx.toolState).issueNumber ??= issue_number;
       const hints = [];
       if (data.comments > 0) {
         hints.push("use get_issue_comments to retrieve all comments for this issue");
@@ -201112,8 +201188,11 @@ function SimilarIssuesTool(ctx) {
     mutates: true,
     parameters: SimilarIssues,
     execute: execute(async (input2) => {
-      if (ctx.payload.event.is_pr || ctx.payload.event.issue_number !== input2.issue_number) {
-        throw new Error("find_similar_issues is limited to the issue that triggered this run");
+      const repoState = primaryRepoState(ctx.toolState);
+      repoState.issueNumber ??= input2.issue_number;
+      const subject = ctx.payload.event.issue_number ?? repoState.issueNumber;
+      if (ctx.payload.event.is_pr || subject !== input2.issue_number) {
+        throw new Error(`find_similar_issues is limited to this run's issue, #${subject}`);
       }
       const response = await apiFetch({
         path: `/api/repo/${ctx.repo.owner}/${ctx.repo.name}/issues/${input2.issue_number}/similar`,
@@ -201395,7 +201474,7 @@ function buildCommonTools(ctx, outputSchema) {
   if (hasSimilarIssues({ repoIntelligence: ctx.repoIntelligence, event: ctx.payload.event })) {
     tools.push(SimilarIssuesTool(ctx));
   }
-  if (ctx.payload.event.issue_number !== void 0 && !ctx.payload.event.is_pr) {
+  if (!ctx.payload.event.is_pr) {
     tools.push(SearchIssuesTool(ctx));
   }
   const isStandalone = ctx.payload.event.trigger === "unknown";
@@ -201793,11 +201872,11 @@ function buildOpenAICompatibleSetupError(params) {
     missing: params.missing,
     where: `Set them on the OpenAI-compatible provider in [Pullfrog's provider settings](${getApiUrl()}/console/${params.owner}#billing), or in the workflow's \`env:\` block with the key as an [Actions secret](${secretsUrl(params)}):`,
     env: [
-      `${OPENAI_COMPATIBLE_BASE_URL_ENV}: https://your-endpoint.example.com/v1`,
-      `${OPENAI_COMPATIBLE_API_KEY_ENV}: \${{ secrets.${OPENAI_COMPATIBLE_API_KEY_ENV} }}`,
-      `${OPENAI_COMPATIBLE_MODEL_ENV}: <model-id>`,
-      `${OPENAI_COMPATIBLE_CONTEXT_ENV}: "128000"`,
-      `${OPENAI_COMPATIBLE_MAX_OUTPUT_ENV}: "16384"`
+      `${params.env.baseUrl}: https://your-endpoint.example.com/v1`,
+      `${params.env.apiKey}: \${{ secrets.${params.env.apiKey} }}`,
+      `${params.env.model}: <model-id>`,
+      `${params.env.context}: "128000"`,
+      `${params.env.maxOutput}: "16384"`
     ],
     note: "Use the real context and output limits of the model your endpoint serves: Pullfrog can't discover them, and without them long runs grow until the endpoint refuses them.",
     guide: "https://docs.pullfrog.com/openai-compatible"
@@ -201831,17 +201910,16 @@ function hasPositiveNumberEnvVar(name) {
   return Number(process.env[name]) > 0;
 }
 function validateOpenAICompatibleSetup(params) {
+  const env2 = openAICompatibleEnv(params.set);
   const missing = [];
-  if (!hasEnvVar2(OPENAI_COMPATIBLE_BASE_URL_ENV)) missing.push(OPENAI_COMPATIBLE_BASE_URL_ENV);
-  if (!hasEnvVar2(OPENAI_COMPATIBLE_API_KEY_ENV)) missing.push(OPENAI_COMPATIBLE_API_KEY_ENV);
-  if (!hasEnvVar2(OPENAI_COMPATIBLE_MODEL_ENV)) missing.push(OPENAI_COMPATIBLE_MODEL_ENV);
-  if (!hasPositiveNumberEnvVar(OPENAI_COMPATIBLE_CONTEXT_ENV))
-    missing.push(OPENAI_COMPATIBLE_CONTEXT_ENV);
-  if (!hasPositiveNumberEnvVar(OPENAI_COMPATIBLE_MAX_OUTPUT_ENV))
-    missing.push(OPENAI_COMPATIBLE_MAX_OUTPUT_ENV);
+  if (!hasEnvVar2(env2.baseUrl)) missing.push(env2.baseUrl);
+  if (!hasEnvVar2(env2.apiKey)) missing.push(env2.apiKey);
+  if (!hasEnvVar2(env2.model)) missing.push(env2.model);
+  if (!hasPositiveNumberEnvVar(env2.context)) missing.push(env2.context);
+  if (!hasPositiveNumberEnvVar(env2.maxOutput)) missing.push(env2.maxOutput);
   if (missing.length > 0) {
     throw new Error(
-      buildOpenAICompatibleSetupError({ owner: params.owner, name: params.name, missing })
+      buildOpenAICompatibleSetupError({ owner: params.owner, name: params.name, missing, env: env2 })
     );
   }
 }
@@ -201897,7 +201975,11 @@ function validateAgentApiKey(params) {
       return;
     }
     if (params.model.startsWith(`${OPENAI_COMPATIBLE_PROVIDER}/`)) {
-      validateOpenAICompatibleSetup({ owner: params.owner, name: params.name });
+      validateOpenAICompatibleSetup({
+        owner: params.owner,
+        name: params.name,
+        set: params.openAICompatibleSet
+      });
       return;
     }
     if (params.model.startsWith(`${AZURE_PROVIDER}/`)) {
@@ -202211,17 +202293,37 @@ function resolveSlug(slug2) {
     }
     return `${AZURE_PROVIDER}/${deployment}`;
   }
-  if (alias?.routing === "openai-compatible") {
-    const modelId = process.env[OPENAI_COMPATIBLE_MODEL_ENV]?.trim();
+  const set2 = heldOpenAICompatibleSet(slug2);
+  if (alias?.routing === "openai-compatible" || set2) {
+    const modelEnv = openAICompatibleEnv(set2).model;
+    const modelId = process.env[modelEnv]?.trim();
     if (!modelId) {
       throw new Error(
-        `\`${OPENAI_COMPATIBLE_MODEL_ENV}\` ${BYOK_SLUG_MARKER} \`${slug2}\`. Set it to the model ID your endpoint serves, on the OpenAI-compatible provider in Pullfrog or in the workflow's \`env:\` block. [OpenAI-compatible setup guide](https://docs.pullfrog.com/openai-compatible)`
+        `\`${modelEnv}\` ${BYOK_SLUG_MARKER} \`${slug2}\`. Set it to the model ID your endpoint serves, on the OpenAI-compatible provider in Pullfrog or in the workflow's \`env:\` block. [OpenAI-compatible setup guide](https://docs.pullfrog.com/openai-compatible)`
       );
     }
     return `${OPENAI_COMPATIBLE_PROVIDER}/${modelId}`;
   }
   return resolveCliModel(slug2);
 }
+function heldOpenAICompatibleSet(slug2) {
+  const set2 = openAICompatibleSetName(slug2);
+  return set2 && Object.values(openAICompatibleEnv(set2)).some(hasEnvVar3) ? set2 : void 0;
+}
+function activateOpenAICompatibleSet(ctx) {
+  const slug2 = process.env.PULLFROG_MODEL?.trim() || ctx.slug?.trim();
+  const set2 = slug2 ? heldOpenAICompatibleSet(slug2) : void 0;
+  if (!set2) return void 0;
+  const from = openAICompatibleEnv(set2);
+  const to = openAICompatibleEnv();
+  for (const field of OPENAI_COMPATIBLE_FIELDS) {
+    const value2 = process.env[from[field]];
+    if (value2 === void 0) delete process.env[to[field]];
+    else process.env[to[field]] = value2;
+  }
+  log.info(`\xBB using the OpenAI-compatible endpoint "${set2}"`);
+  return set2;
+}
 function resolveModel(ctx) {
   const envModel = process.env.PULLFROG_MODEL?.trim();
   if (envModel) {
@@ -203264,7 +203366,7 @@ Rules:
 ### GitHub
 
 Use MCP tools from ${pullfrogMcpName} for all GitHub operations. Never use the \`gh\` CLI \u2014 it is not authenticated and will fail. The MCP tools handle authentication and enforce permissions.
-${hasSimilarIssues({ repoIntelligence: ctx.repoIntelligence, event: ctx.payload.event }) ? `
+${ctx.payload.event.issue_number !== void 0 && hasSimilarIssues({ repoIntelligence: ctx.repoIntelligence, event: ctx.payload.event }) ? `
 #### Duplicate detection (enabled for this repository)
 
 Call \`${t("find_similar_issues")}\` for #${ctx.payload.event.issue_number} before planning. If it duplicates an existing issue, link that instead of producing a plan; never close or label on similarity alone.
@@ -205143,6 +205245,9 @@ function resolveModelForLog(ctx) {
 function resolveEffortForLog(ctx) {
   const effort = resolveRunEffort(ctx);
   if (!ctx.resolvedModel && !ctx.payload.proxyModel) return "pending \u2014 model not chosen yet";
+  if (effort.declarable && ctx.agentName === "opencode") {
+    return "pending \u2014 reading the variants opencode declares";
+  }
   if (!effort.alias) return "not applied \u2014 model not recognized";
   if (!effort.rung) return "n/a (model has no effort control)";
   return effort.configured ? effort.rung : `${effort.rung} (default)`;
@@ -205161,9 +205266,7 @@ function logRunStartup(ctx) {
   log.info(
     `\xBB model:   ${resolveModelForLog({ payload: ctx.payload, resolvedModel: ctx.resolvedModel })}`
   );
-  log.info(
-    `\xBB effort:  ${resolveEffortForLog({ payload: ctx.payload, resolvedModel: ctx.resolvedModel })}`
-  );
+  log.info(`\xBB effort:  ${resolveEffortForLog(ctx)}`);
   const routing = ctx.payload.routing;
   if (routing) {
     log.info(
@@ -205434,6 +205537,7 @@ async function main() {
       const count = Object.keys(runContext.dbSecrets).length;
       if (count > 0) log.info(`\xBB ${count} db secret(s) loaded`);
     }
+    const openAICompatibleSet = activateOpenAICompatibleSet({ slug: payload.model });
     await initializeCredentialPool({ ctx: runContext, slug: payload.model, injected });
     installCodexAuth();
     installXaiAuth();
@@ -205582,7 +205686,8 @@ async function main() {
               owner: runContext.repo.owner,
               name: runContext.repo.name,
               secretsUnavailable: runContext.secretsUnavailable,
-              routerUnfunded: runContext.routerUnfunded
+              routerUnfunded: runContext.routerUnfunded,
+              openAICompatibleSet
             });
           } catch (missingKey) {
             const funded = runContext.trialFallback && missingKey instanceof NoUsableCredentialError ? await resolveTrialFallback({

package/dist/internal/index.d.ts

@@ -7,6 +7,7 @@ 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, 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, modelIdLabel, 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, resolvePickModel, resolveRoutedModel, resolveRung, routerProxyOptOut, rungLabel, rungPosition, SUBSIDY_RUNG, TRIAL_FUNDED_USD_LIMIT, } from "../external.ts";
+export { isOpenAICompatibleSetName, openAICompatibleEnv, openAICompatibleSetAlias, openAICompatibleSetName, openAICompatibleSetOf, openAICompatibleSets, } from "../models.ts";
 export type { Mode } from "../modes.ts";
 export { modes } from "../modes.ts";
 export { type CommercialRefusal, 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.104",
+  version: "0.1.106",
   cliContractVersion: "1",
   type: "module",
   bin: {
@@ -20079,7 +20079,7 @@ var repoConfigFields = [
     key: "address-reviews.enabled",
     field: "codingAddressReviews",
     kind: "toggle",
-    description: "address review feedback"
+    description: "address reviews on Pullfrog-authored PRs"
   },
   {
     key: "fix-ci.own-prs",
@@ -21651,7 +21651,10 @@ function modelHasStoredAuth(params) {
   const authVars = [
     ...getModelEnvVars(slug),
     ...getModelManagedCredentials(slug),
-    ...HARNESS_ONLY_CREDENTIALS[getModelProvider(slug)] ?? []
+    ...HARNESS_ONLY_CREDENTIALS[getModelProvider(slug)] ?? [],
+    // the default endpoint's vars above still count: a runner holding no such set runs the
+    // slug as a raw model id on it
+    ...openAICompatibleSetEnvVars(slug)
   ];
   return authVars.some((v) => params.secretNames.includes(v));
 }
@@ -21877,6 +21880,46 @@ function isOssAllowedModel(slug) {
 function getAutoSelectHintModel() {
   return defaultProxyDisplayName;
 }
+var OPENAI_COMPATIBLE_PROVIDER = "openai-compatible";
+function isOpenAICompatibleSetName(name) {
+  return name !== "byok" && name.length <= 32 && /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name);
+}
+function openAICompatibleSetName(slug) {
+  const prefix = `${OPENAI_COMPATIBLE_PROVIDER}/`;
+  if (!slug.startsWith(prefix)) return void 0;
+  const name = slug.slice(prefix.length);
+  return isOpenAICompatibleSetName(name) ? name : void 0;
+}
+function openAICompatibleEnv(name) {
+  const prefix = `OPENAI_COMPATIBLE_${name ? `${name.toUpperCase().replaceAll("-", "_")}_` : ""}`;
+  return {
+    baseUrl: `${prefix}BASE_URL`,
+    apiKey: `${prefix}API_KEY`,
+    model: `${prefix}MODEL`,
+    context: `${prefix}CONTEXT`,
+    maxOutput: `${prefix}MAX_OUTPUT`
+  };
+}
+function openAICompatibleSetEnvVars(slug) {
+  const set2 = openAICompatibleSetName(slug);
+  if (!set2) return [];
+  const env = openAICompatibleEnv(set2);
+  return [env.baseUrl, env.apiKey, env.model];
+}
+function openAICompatibleSetOf(envName) {
+  const match = /^OPENAI_COMPATIBLE_([A-Z0-9]+(?:_[A-Z0-9]+)*)_(?:BASE_URL|API_KEY|MODEL|CONTEXT|MAX_OUTPUT)$/.exec(
+    envName
+  );
+  const name = match?.[1]?.toLowerCase().replaceAll("_", "-");
+  return name && isOpenAICompatibleSetName(name) ? name : void 0;
+}
+function openAICompatibleSets(names) {
+  return [...new Set(names.flatMap((name) => openAICompatibleSetOf(name) ?? []))].sort();
+}
+function openAICompatibleSetAlias(set2) {
+  const byok = resolveDisplayAlias(`${OPENAI_COMPATIBLE_PROVIDER}/byok`);
+  return byok && { ...byok, slug: `${OPENAI_COMPATIBLE_PROVIDER}/${set2}`, displayName: set2 };
+}
 var PROVIDER_GATEWAY_URL_ENV = {
   anthropic: "ANTHROPIC_BASE_URL",
   openai: "OPENAI_BASE_URL"
@@ -23534,6 +23577,7 @@ export {
   isEffortPosition,
   isLeapingIntoActionCommentBody,
   isLiveChecklistCommentBody,
+  isOpenAICompatibleSetName,
   isOssAllowedModel,
   isPullfrog,
   isRouterTier,
@@ -23544,6 +23588,11 @@ export {
   modelIdLabel,
   modes,
   offeredRungs,
+  openAICompatibleEnv,
+  openAICompatibleSetAlias,
+  openAICompatibleSetName,
+  openAICompatibleSetOf,
+  openAICompatibleSets,
   ossFundedModelNames,
   parseCodexAuthBody,
   parseEffortPosition,

package/dist/models.d.ts

@@ -464,6 +464,27 @@ export declare const OPENAI_COMPATIBLE_CONTEXT_ENV = "OPENAI_COMPATIBLE_CONTEXT"
  * `context` + `output` together, so the pair is validated and emitted as a unit.
  */
 export declare const OPENAI_COMPATIBLE_MAX_OUTPUT_ENV = "OPENAI_COMPATIBLE_MAX_OUTPUT";
+/**
+ * a NAMED OpenAI-compatible endpoint: the slug `openai-compatible/<name>` runs on the five
+ * `OPENAI_COMPATIBLE_<NAME>_*` values, so one account holds several endpoints and each repo,
+ * trigger or `--model=` picks one. `byok` stays the unnamed default on the bare names. 32 is
+ * what keeps `OPENAI_COMPATIBLE_<NAME>_MAX_OUTPUT` under the 64-character secret-name cap.
+ */
+export declare function isOpenAICompatibleSetName(name: string): boolean;
+/**
+ * the set a slug names, by shape alone. `openai-compatible/<x>` is also a raw specifier (model
+ * `x` on the default endpoint), so a runner treats it as a set only when it holds that set's values.
+ */
+export declare function openAICompatibleSetName(slug: string): string | undefined;
+export declare const OPENAI_COMPATIBLE_FIELDS: readonly ["baseUrl", "apiKey", "model", "context", "maxOutput"];
+/** the env var names one endpoint is configured by: a named set's, or the default's. */
+export declare function openAICompatibleEnv(name?: string): Record<(typeof OPENAI_COMPATIBLE_FIELDS)[number], string>;
+/** the set a variable belongs to: `OPENAI_COMPATIBLE_VLLM_A_API_KEY` → `vllm-a`. */
+export declare function openAICompatibleSetOf(envName: string): string | undefined;
+/** the named endpoints `names` (stored secret or env var names) hold any value of. */
+export declare function openAICompatibleSets(names: string[]): string[];
+/** a named endpoint as a picker entry: the default endpoint's routing alias under its own slug. */
+export declare function openAICompatibleSetAlias(set: string): ModelAlias | undefined;
 /**
  * Providers whose endpoint can be re-pointed at a customer gateway, and the env
  * var that does it. Deliberately a short explicit map rather than a derived

package/dist/utils/agent.d.ts

@@ -1,4 +1,13 @@
 import type { Agent } from "../agents/index.ts";
+/**
+ * make the run's named set (`openai-compatible/<name>`) its endpoint: the set's five values
+ * replace the bare `OPENAI_COMPATIBLE_*` that validation and the opencode provider read. a value
+ * the set lacks is cleared, never inherited, so the default endpoint's key cannot reach the set's
+ * URL. returns the set, so setup errors can name its own variables.
+ */
+export declare function activateOpenAICompatibleSet(ctx: {
+    slug: string | undefined;
+}): string | undefined;
 /**
  * resolve the effective model for this run.
  *

package/dist/utils/apiKeys.d.ts

@@ -121,6 +121,8 @@ export declare function validateAgentApiKey(params: {
      * says nothing about what the user actually configured. */
     secretsUnavailable?: boolean | undefined;
     routerUnfunded?: boolean | undefined;
+    /** the named OpenAI-compatible set the run is on, from `activateOpenAICompatibleSet`. */
+    openAICompatibleSet?: string | undefined;
 }): void;
 /**
  * Detect agent-runtime auth failures that should be reformatted as an actionable

package/dist/utils/runEffort.d.ts

@@ -20,6 +20,11 @@ export interface RunEffort {
     rung: string | undefined;
     /** the catalog alias the ladder came from, if we recognized one. */
     alias: ModelAlias | undefined;
+    /**
+     * true when the catalog has no ladder for a configured effort and the variants
+     * the opencode server declares for the model may stand in (`declaredVariants`).
+     */
+    declarable: boolean;
 }
 /**
  * the position a subsidised run is pinned to — the `high` rung on the ladder of
@@ -39,4 +44,9 @@ export declare function ossEffortFloor(ctx: {
 export declare function resolveRunEffort(ctx: {
     payload: ResolvedPayload;
     resolvedModel?: string | undefined;
+    /**
+     * the variant names the opencode server lists for the running model, in its
+     * order. only consulted when the catalog has no alias for the model.
+     */
+    declaredVariants?: readonly string[] | undefined;
 }): RunEffort;

package/dist/utils/setup.d.ts

@@ -14,6 +14,8 @@ export declare function createTempDirectory(): {
     path: string;
     [Symbol.dispose]: () => void;
 };
+/** the `post:` hook's half of `createTempDirectory`: removes the directory a cancelled run left. */
+export declare function removeAbandonedTempDirectory(): void;
 /**
  * snapshot-and-delete the GHA runner's known credential leak surfaces inside
  * `$RUNNER_TEMP` before the agent spawns. without this, a shell-capable agent

package/package.json

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