pullfrog 0.1.105 → 0.1.107

package/dist/mcp/server.d.ts

@@ -21,6 +21,8 @@ export interface ToolContext {
     apiToken: string;
     modes: Mode[];
     postCheckoutScript: string | null;
+    botLogin: string;
+    botUserId: string;
     prepushScript: string | null;
     prApproveEnabled: boolean;
     reviewDrafts: boolean;

package/dist/models.d.ts

@@ -83,7 +83,7 @@ interface ModelDef {
     /** concrete models.dev specifier, e.g. "anthropic/claude-opus-4-6" */
     resolve: string;
     /** full models.dev specifier for the OpenRouter equivalent, e.g. "openrouter/anthropic/claude-opus-4.6" */
-    openRouterResolve?: string;
+    openRouterResolve?: string | undefined;
     preferred?: boolean;
     envVars?: readonly string[];
     isFree?: boolean;
@@ -97,11 +97,15 @@ interface ModelDef {
      * 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?: readonly string[] | undefined;
     /** effort rungs on the OpenRouter route when they differ — see ModelAlias.openRouterEffort */
-    openRouterEffort?: readonly string[];
+    openRouterEffort?: readonly string[] | undefined;
     /** hide from selectable lists. does NOT affect resolution; for that use `fallback`. */
     hidden?: boolean;
+    /** `resolve` and `openRouterResolve` are chosen by hand (a rolling `~…-latest` pointer, a `-pro`
+     * id models.dev lacks, a dated or held-back build), so the server never looks them up by
+     * models.dev's canonical id. see wiki/model-resolution.md. */
+    pinned?: boolean;
 }
 export interface ProviderConfig {
     displayName: string;
@@ -113,7 +117,8 @@ export interface ProviderConfig {
     managedCredentials?: readonly string[];
     models: Record<string, ModelDef>;
 }
-export declare const providers: {
+/** this build's own registry. `providers` starts as this copy and `installProviders` replaces it. */
+export declare const bundledProviders: {
     anthropic: ProviderConfig;
     openai: ProviderConfig;
     google: ProviderConfig;
@@ -131,7 +136,9 @@ export declare const providers: {
     openrouter: ProviderConfig;
     vercel: ProviderConfig;
 };
-export type ModelProvider = keyof typeof providers;
+/** the registry every lookup below reads: this file's copy, until `installProviders` swaps in the server's. */
+export declare let providers: Record<string, ProviderConfig>;
+export type ModelProvider = keyof typeof bundledProviders;
 export declare function parseModel(slug: string): {
     provider: string;
     model: string;
@@ -205,7 +212,7 @@ export declare function resolvePickModel(params: {
     proxied: boolean;
     secretNames: string[];
 }): string | undefined;
-export declare const modelAliases: ModelAlias[];
+export declare let modelAliases: ModelAlias[];
 /**
  * `repo.model` sentinels for the two managed auto tiers. stored verbatim in
  * the DB (they pass the `provider/model` shape check) and resolved to a
@@ -275,7 +282,7 @@ export declare function isAutoRouted(slug: string | null | undefined): boolean;
 export declare function isAutoSlug(slug: string | null | undefined): boolean;
 export declare function autoRoutedSlug(provider: string): string;
 /** the providers a BYOK repo can put on Auto — exactly the ones with a ladder */
-export declare const ROUTED_PROVIDERS: readonly {
+export declare let ROUTED_PROVIDERS: readonly {
     key: string;
     displayName: string;
 }[];
@@ -353,9 +360,20 @@ export declare function resolveModelRung(params: {
     position: EffortPosition;
     useOpenRouter: boolean;
 }): string | undefined;
-export declare const DEFAULT_PROXY_MODEL: string;
-export declare const TRIAL_PROXY_MODEL: string;
-export declare const TRIAL_PROXY_DISPLAY_NAME: string;
+/**
+ * OpenRouter target when Router or OSS funding is active and `repo.model` is null.
+ * resolved through the efficient tier's fallback chain, so if that tier's backing
+ * model is given a `fallback` (e.g. to ride out a temporary outage) the OSS/Router
+ * default follows the substitute instead of pinning the unavailable model.
+ */
+export declare let DEFAULT_PROXY_MODEL: string;
+/**
+ * what a Pullfrog-funded trial run falls back to. apart from `DEFAULT_PROXY_MODEL` because the
+ * trial is capped at `TRIAL_FUNDED_USD_LIMIT` per account, so first-impression quality outranks price.
+ * see wiki/trial-model-fallback.md.
+ */
+export declare let TRIAL_PROXY_MODEL: string;
+export declare let TRIAL_PROXY_DISPLAY_NAME: string;
 /** lifetime cap, in USD, on the model usage Pullfrog funds for an account's trial runs. */
 export declare const TRIAL_FUNDED_USD_LIMIT = 10;
 /**
@@ -395,6 +413,12 @@ export declare const OSS_RECOMMENDED_MODEL: string;
  * is a catalog, not copy.
  */
 export declare function ossFundedModelNames(): string[];
+/**
+ * Swaps in the server's copy of `providers`, so a merged registry change reaches runs at deploy
+ * rather than at the next release. A copy this build can't derive from (an alias its proxy
+ * defaults, ladders or OSS allowlist need is gone) is refused, and the bundled one stays.
+ */
+export declare function installProviders(next: Record<string, ProviderConfig>): void;
 /**
  * whether an OSS repo's stored pick is one the program funds. resolves through
  * the fallback chain first, so `auto/*` sentinels and deprecated slugs are

package/dist/modes.d.ts

@@ -4,7 +4,11 @@ export interface Mode {
     description: string;
     prompt?: string | undefined;
 }
-export declare function computeModes(agentId: AgentId, signedCommits?: boolean): Mode[];
+export declare function computeModes(params: {
+    agentId: AgentId;
+    signedCommits?: boolean;
+    botLogin?: string;
+}): Mode[];
 export declare const modes: Mode[];
 /**
  * modes that legitimately never modify the working tree. used by the post-run

package/dist/utils/isPullfrog.d.ts

@@ -1,4 +1,16 @@
 /**
- * true when a GitHub login belongs to Pullfrog's production or development app.
+ * the App this run operates as, from run-context. set once in `main.ts` before
+ * any actor check; a customer-registered App is otherwise invisible to the
+ * gates below (auto-merge would not wait on its unresolved threads, and would
+ * read its own changes-requested review as a human block).
+ */
+export declare function setBotLogin(login: string): void;
+/**
+ * true when a GitHub login belongs to Pullfrog's production or development app,
+ * or to the App this run operates as.
  */
 export declare function isPullfrog(actor: string | null | undefined): boolean;
+/** whether `actor` is `botLogin`: GraphQL drops the `[bot]` suffix REST carries. */
+export declare function isBotLogin(actor: string | null | undefined, botLogin: string): boolean;
+/** the handles a mention of this run's bot can use; a custom App may have been renamed. */
+export declare function mentionHandles(): string[];

package/dist/utils/openCodeModels.d.ts

@@ -9,6 +9,15 @@ export declare function openCodeHomeEnv(tmpdir: string): {
     XDG_CACHE_HOME: string;
     XDG_STATE_HOME: string;
 };
+/**
+ * Downloads opencode's model catalog into the file it reads first (`packages/core/src/models-dev.ts`),
+ * before any opencode process starts. With that file missing, opencode serves the snapshot compiled
+ * into its binary and swaps in the live catalog only if a background download lands in time, so a
+ * model released after the build fails at session start whenever the download loses (#1520).
+ */
+export declare function seedModelsCatalog(tmpdir: string): Promise<void>;
+/** Why `seedModelsCatalog` failed, leaving opencode on its build-time snapshot. */
+export declare function getModelsCatalogFailure(): string | undefined;
 /**
  * Why the last `opencode models` came back empty, in opencode's own words.
  *

package/dist/utils/outstandingThreads.d.ts

@@ -7,6 +7,8 @@ export type OutstandingThreadsCtx = {
         owner: string;
         name: string;
     };
+    /** the server's, which knows the owner's own App bot; a run's `isPullfrog` already does. */
+    isPullfrog?: (login: string | null | undefined) => boolean;
 };
 /**
  * count unresolved review threads on a PR whose root comment was authored by

package/dist/utils/publishedCatalogs.d.ts

@@ -0,0 +1,50 @@
+import type { ProviderConfig } from "../models.ts";
+type ReasoningOptions = {
+    type: string;
+    values?: string[];
+}[] | undefined;
+export type ModelsDevCatalog = Record<string, {
+    models: Record<string, {
+        canonical_model_id?: string;
+        status?: string;
+        reasoning_options?: ReasoningOptions;
+    }>;
+}>;
+export interface PublishedCatalogs {
+    /** `https://models.dev/api.json` */
+    modelsDev: ModelsDevCatalog;
+    /** `https://ai-gateway.vercel.sh/v1/models`, whose ladders outrank models.dev's for `vercel/*` */
+    gateway: {
+        data: {
+            id: string;
+            reasoning_options?: ReasoningOptions;
+        }[];
+    };
+    /** the ids each route's own API lists: Zen, Go, OpenRouter and the Vercel gateway */
+    served: Record<RouteProvider, ReadonlySet<string>>;
+}
+/** every catalog `applyPublishedCatalogs` reads, fetched together; rejects when any one fails */
+export declare function fetchPublishedCatalogs(signal: AbortSignal): Promise<PublishedCatalogs>;
+/** the providers that re-host another vendor's models, so their ids can be looked up rather than kept */
+declare const ROUTE_PROVIDERS: readonly ["opencode", "opencode-go", "openrouter", "vercel"];
+type RouteProvider = (typeof ROUTE_PROVIDERS)[number];
+/**
+ * models Zen LISTS in `/zen/v1/models` but will not actually serve — the endpoint answers 400
+ * `[NOT_FOUND] ... not deployed`, on both Zen tiers. Membership is not availability, so these are
+ * subtracted wherever a served list is read. Hand-kept, since only a call to the model can tell: add
+ * one when `models-live` catches it, and delete it once the model completes a run again.
+ */
+export declare const ZEN_UNDEPLOYED: readonly string[];
+type Ctx = {
+    catalogs: PublishedCatalogs;
+    providers: Record<string, ProviderConfig>;
+};
+/**
+ * The registry as the published catalogs describe it today. A route copy of a vendor model takes
+ * the one id its route serves under that model's canonical id, `openRouterResolve` likewise; each
+ * route's effort ladder is the one it publishes; and a dead free Zen model falls back to Big
+ * Pickle. Whatever the catalogs can't settle unambiguously keeps the value written in
+ * `action/models.ts`, as does every `pinned` entry's id. See wiki/model-resolution.md.
+ */
+export declare function applyPublishedCatalogs(params: Ctx): Record<string, ProviderConfig>;
+export {};

package/dist/utils/runContext.d.ts

@@ -1,5 +1,5 @@
 import type { PushPermission, ShellPermission } from "../external.ts";
-import type { RouterTier } from "../models.ts";
+import type { ProviderConfig, RouterTier } from "../models.ts";
 import type { CommercialRefusal } from "./billingErrors.ts";
 import type { RepoContext } from "./github.ts";
 import type { CredentialAccess } from "./subscriptionCredentials.ts";
@@ -45,6 +45,8 @@ export interface RepoSettings {
     codexAgent: boolean;
     signedCommits: boolean;
     repoIntelligence: boolean;
+    botLogin: string;
+    botUserId: string;
     progressComments: boolean;
     statusChecks: boolean;
     approvalCheck: boolean;
@@ -103,6 +105,13 @@ export interface RunContext {
     /** the trial account's remaining funded credits, in USD, when it is inside its
      * trial at all. zero or below means the credits are used up. */
     trialCreditsLeftUsd?: number | undefined;
+    /** the deployed server's alias registry, which replaces the one bundled into this build. */
+    modelRegistry?: ModelRegistry | undefined;
+}
+export interface ModelRegistry {
+    providers: Record<string, ProviderConfig>;
+    /** the harness CLIs the server's registry was written against. see `getHarnessPins`. */
+    harnessPins: Record<string, string>;
 }
 /**
  * fetch run context from Pullfrog API

package/dist/utils/runContextData.d.ts

@@ -1,5 +1,5 @@
 import type { Octokit } from "@octokit/rest";
-import type { RouterTier } from "../models.ts";
+import { type RouterTier } from "../models.ts";
 import type { CommercialRefusal } from "./billingErrors.ts";
 import { type OctokitWithPlugins } from "./github.ts";
 import { type AccountPlan, type RepoSettings } from "./runContext.ts";

package/dist/utils/runErrorRenderer.d.ts

@@ -77,6 +77,8 @@ type RenderRunErrorInput = {
     credential?: AgentCredential | undefined;
     /** the run was served by the account's free trial credits. */
     trial?: boolean | undefined;
+    /** why opencode's live model catalog could not be downloaded, leaving it on its build-time snapshot. */
+    modelsCatalogFailure?: string | undefined;
 };
 export declare function renderRunError(input: RenderRunErrorInput): RenderedRunError;
 export {};

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
@@ -72,6 +74,8 @@ export interface GitContext {
     toolState: ToolState;
     shell: ShellPermission;
     postCheckoutScript: string | null;
+    botLogin: string;
+    botUserId: string;
 }
 export type SetupGitParams = GitContext;
 /** GitContext plus an explicit working-tree directory (primary cwd or a

package/dist/utils/version.d.ts

@@ -1,2 +1,4 @@
 import packageJson from "../package.json";
 export declare function getDevDependencyVersion(name: keyof typeof packageJson.devDependencies): string;
+/** the CLIs the harnesses install. a model registry is written against these, so a served one applies only where they match. */
+export declare function getHarnessPins(): Record<string, string>;

package/package.json

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