pullfrog 0.1.66 → 0.1.68

package/dist/internal/index.d.ts

@@ -3,7 +3,7 @@
  * Re-exports shared types, values, and utilities needed by the Next.js app.
  */
 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, isOssAllowedModel, modelAliases, modelHasStoredAuth, OSS_MODEL_ALLOWLIST, OSS_RECOMMENDED_MODEL, offeredRungs, ossFundedModelNames, parseEffortPosition, parseModel, providers, pullfrogMcpName, resolveAutoTier, resolveCliModel, resolveDisplayAlias, resolveModelRung, resolveModelSlug, resolveOpenRouterModel, resolveRung, rungLabel, rungPosition, } 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, isOssAllowedModel, modelAliases, modelHasStoredAuth, OSS_MODEL_ALLOWLIST, OSS_RECOMMENDED_MODEL, offeredRungs, ossFundedModelNames, parseEffortPosition, parseModel, providers, pullfrogMcpName, resolveAutoTier, resolveCliModel, resolveDisplayAlias, resolveModelRung, resolveModelSlug, resolveOpenRouterModel, resolveRung, rungLabel, rungPosition, SUBSIDY_RUNG, } from "../external.ts";
 export type { Mode } from "../modes.ts";
 export { modes } from "../modes.ts";
 export { commercialPaywallBody } from "../utils/billingErrors.ts";

package/dist/internal.js

@@ -2,6 +2,7 @@ import { createRequire as __createRequire } from 'module'; import { fileURLToPat
 
 // effort.ts
 var DEFAULT_EFFORT_POSITION = 0.5;
+var SUBSIDY_RUNG = "high";
 var EFFORT_ALIASES = {
   low: 0,
   medium: 0.25,
@@ -338,6 +339,69 @@ var providers = {
       }
     }
   }),
+  // the same models as `moonshotai` above, billed against a Kimi membership
+  // instead of a Moonshot API balance — a separate endpoint, separate model
+  // ids and a separate key, which is why it is a provider rather than a second
+  // `envVars` entry. no provider injection is needed: models.dev carries
+  // `kimi-for-coding` (api `https://api.kimi.com/coding/v1`, npm
+  // `@ai-sdk/anthropic`) and opencode's env loop enables it from a bare
+  // `KIMI_API_KEY`, verified against our pinned opencode-ai@1.18.5 — all four
+  // ids list in `opencode models` and a run reaches Kimi's own auth check.
+  //
+  // NO `openRouterResolve` ON PURPOSE. OpenRouter cannot serve a Kimi
+  // membership, so a Router path here would silently bill the wallet for
+  // Moonshot pay-as-you-go under a slug picked for the opposite reason. The
+  // absence is load-bearing: `isCardGatedModel` reads it as "not Router-
+  // resolvable", `decideModelAccess` answers an explicit pick with the
+  // `router` copy ("add your own provider key"), and run-context clamps a
+  // keyless Router pick to the default subsidy model with `noRouterPath`.
+  "kimi-for-coding": provider({
+    // "Kimi Code" is the product name on kimi.com/code and in the console the
+    // key is minted from. The provider KEY has to stay `kimi-for-coding` — it
+    // is models.dev's id, so it is what `enabled_providers` and every
+    // `resolve` prefix must spell.
+    displayName: "Kimi Code",
+    envVars: ["KIMI_API_KEY"],
+    models: {
+      // the tier each model needs is in `description` because Kimi answers an
+      // out-of-tier request with 401 — indistinguishable from a bad key by
+      // status alone, and only `isKimiPlanTierError` tells them apart after the
+      // fact. saying it in the picker is the half that stops the run happening.
+      "kimi-k3": {
+        displayName: "Kimi K3",
+        description: "1M context, but only on Allegretto and above \xB7 Moderato caps it at 256K",
+        resolve: "kimi-for-coding/k3",
+        effort: ["low", "high", "max"],
+        subagentModel: "kimi-k2"
+      },
+      // `preferred` sits on the 256K variant rather than the 1M flagship, which
+      // inverts the usual "top tier wins" rule for a reason specific to Kimi:
+      // below Allegretto the two are the SAME 256K ceiling and `k3` charges
+      // roughly double the quota for it, so on the median tier the flagship is
+      // strictly dominated rather than merely pricier. This flag seeds the
+      // onboarding pick (`getRecommendedSlug`) and wins key-only auto-select
+      // (`autoSelectModel`), which are exactly the two moments nobody has
+      // chosen yet.
+      "kimi-k3-256k": {
+        displayName: "Kimi K3 256K",
+        description: "Same model at 256K for ~half the quota \xB7 Moderato or above",
+        resolve: "kimi-for-coding/k3-256k",
+        effort: ["low", "high", "max"],
+        preferred: true,
+        subagentModel: "kimi-k2"
+      },
+      "kimi-k2": {
+        displayName: "Kimi K2",
+        description: "Included in every Kimi membership tier",
+        resolve: "kimi-for-coding/kimi-for-coding"
+      },
+      "kimi-k2-highspeed": {
+        displayName: "Kimi K2 HighSpeed",
+        description: "~6x output speed for ~3x quota \xB7 needs Allegretto or above",
+        resolve: "kimi-for-coding/kimi-for-coding-highspeed"
+      }
+    }
+  }),
   opencode: provider({
     displayName: "OpenCode Zen",
     envVars: ["OPENCODE_API_KEY"],
@@ -354,6 +418,15 @@ var providers = {
         // the model does cost nothing.
         isFree: true
       },
+      // Zen meters Fable like any other model, so this route reaches it without
+      // the Anthropic access grant `anthropic/claude-fable` still needs.
+      "claude-fable": {
+        displayName: "Claude Fable",
+        resolve: "opencode/claude-fable-5-1",
+        effort: ["low", "medium", "high", "xhigh", "max"],
+        openRouterResolve: "openrouter/~anthropic/claude-fable-latest",
+        subagentModel: "claude-sonnet"
+      },
       "claude-opus": {
         displayName: "Claude Opus",
         resolve: "opencode/claude-opus-5",
@@ -467,6 +540,17 @@ var providers = {
         effort: ["minimal", "low", "medium", "high"],
         openRouterResolve: "openrouter/google/gemini-3.6-flash"
       },
+      // Zen serves K3, but rule 7 can only move a mirror when its upstream moves,
+      // so the K3 generation could never reach this block by bumping `kimi-k2`.
+      "kimi-k3": {
+        displayName: "Kimi K3",
+        resolve: "opencode/kimi-k3",
+        // Zen publishes a single rung for K3 where OpenRouter publishes three.
+        effort: ["max"],
+        openRouterEffort: ["low", "high", "max"],
+        openRouterResolve: "openrouter/moonshotai/kimi-k3",
+        subagentModel: "kimi-k2"
+      },
       "kimi-k2": {
         displayName: "Kimi K2",
         // k2.7-code is UNDEPLOYED on Zen — still listed in /zen/v1/models, but
@@ -478,25 +562,58 @@ var providers = {
         resolve: "opencode/kimi-k2.6",
         openRouterResolve: "openrouter/moonshotai/kimi-k2.7-code"
       },
+      // M3 is its own line beside M2, not a bump of it — same reason `kimi-k3`
+      // sits beside `kimi-k2` rather than replacing it.
+      "minimax-m3": {
+        displayName: "MiniMax M3",
+        resolve: "opencode/minimax-m3",
+        openRouterResolve: "openrouter/minimax/minimax-m3"
+      },
       // slug pins the m2 line for DB stability; resolve tracks the current m2.7.
       "minimax-m2.5": {
         displayName: "MiniMax M2",
         resolve: "opencode/minimax-m2.7",
         openRouterResolve: "openrouter/minimax/minimax-m2.7"
       },
+      // Z.ai and xAI reach Zen subscribers only here — before this, `opencode-go`
+      // was the catalog's only GLM route, and Grok had no Zen route at all.
+      glm: {
+        displayName: "GLM",
+        resolve: "opencode/glm-5.2",
+        effort: ["high", "max"],
+        openRouterEffort: ["high", "xhigh"],
+        openRouterResolve: "openrouter/z-ai/glm-5.2"
+      },
+      grok: {
+        displayName: "Grok",
+        resolve: "opencode/grok-4.6",
+        effort: ["low", "medium", "high", "xhigh"],
+        openRouterResolve: "openrouter/x-ai/grok-4.6"
+      },
       "gpt-5-nano": {
         displayName: "GPT Nano",
         resolve: "opencode/gpt-5-nano",
         effort: ["minimal", "low", "medium", "high"],
         openRouterResolve: "openrouter/openai/gpt-5-nano"
       },
+      // Zen's live free MiMo, and the second free row in a menu that big-pickle
+      // was alone in since `mimo-v2-pro-free` lost its model.
+      mimo: {
+        displayName: "MiMo",
+        resolve: "opencode/mimo-v2.5-free",
+        // free to run, still gated on the provider's own OPENCODE_API_KEY —
+        // see the big-pickle note above (#1077).
+        isFree: true
+      },
       "mimo-v2-pro-free": {
         displayName: "MiMo V2 Pro",
         resolve: "opencode/mimo-v2-pro-free",
         // free to run, still gated on the provider's own OPENCODE_API_KEY —
         // see the big-pickle note above (#1077).
         isFree: true,
-        fallback: "opencode/big-pickle"
+        // the model id Zen dropped; land a stored MiMo pick back on MiMo rather
+        // than on the unrelated model it had to settle for while none was live.
+        fallback: "opencode/mimo"
       },
       "minimax-m2.5-free": {
         displayName: "MiniMax M2",
@@ -591,6 +708,16 @@ var providers = {
         resolve: "opencode-go/qwen3.7-plus",
         openRouterResolve: "openrouter/qwen/qwen3.7-plus"
       },
+      // the cheap rung Alibaba added under Plus (0.15/0.47 against 0.5/3), and
+      // the only model either OpenCode plan has added since this block was written.
+      "qwen-flash": {
+        displayName: "Qwen Flash",
+        resolve: "opencode-go/qwen3.8-flash",
+        effort: ["low", "medium", "xhigh"],
+        // the Go route publishes rungs where OpenRouter publishes none.
+        openRouterEffort: [],
+        openRouterResolve: "openrouter/qwen/qwen3.8-flash"
+      },
       // MiniMax — parity with opencode/* and openrouter/*; the m2 slug pins the
       // line for DB stability while the resolve tracks the current m2.7.
       "minimax-m3": {
@@ -890,6 +1017,80 @@ var providers = {
         openRouterResolve: "openrouter/minimax/minimax-m3"
       }
     }
+  }),
+  vercel: provider({
+    // Vercel AI Gateway — one key serves every model it fronts. model IDs use
+    // the models.dev `vercel` catalog's own naming (dotted versions, e.g.
+    // `anthropic/claude-opus-5`, `zai/glm-5.3`), and effort ladders mirror that
+    // catalog's entries, not the upstream vendor's. deliberately no
+    // `openRouterResolve`: a gateway pick is BYOK-only — silently rerouting it
+    // over the Router proxy would bill the wallet for traffic the user pointed
+    // at their own gateway.
+    displayName: "Vercel AI Gateway",
+    envVars: ["AI_GATEWAY_API_KEY"],
+    models: {
+      "claude-opus": {
+        displayName: "Claude Opus",
+        resolve: "vercel/anthropic/claude-opus-5",
+        effort: ["low", "medium", "high", "xhigh", "max"],
+        preferred: true,
+        subagentModel: "claude-sonnet"
+      },
+      "claude-sonnet": {
+        displayName: "Claude Sonnet",
+        resolve: "vercel/anthropic/claude-sonnet-5",
+        effort: ["low", "medium", "high", "xhigh"]
+      },
+      "claude-haiku": {
+        displayName: "Claude Haiku",
+        resolve: "vercel/anthropic/claude-haiku-4.5"
+      },
+      "gpt-sol": {
+        displayName: "GPT Sol",
+        resolve: "vercel/openai/gpt-5.6-sol",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"],
+        subagentModel: "gpt-terra"
+      },
+      "gpt-terra": {
+        displayName: "GPT Terra",
+        resolve: "vercel/openai/gpt-5.6-terra",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"]
+      },
+      "gpt-luna": {
+        displayName: "GPT Luna",
+        resolve: "vercel/openai/gpt-5.6-luna",
+        effort: ["none", "low", "medium", "high", "xhigh", "max"]
+      },
+      "gemini-pro": {
+        displayName: "Gemini Pro",
+        resolve: "vercel/google/gemini-3.1-pro-preview",
+        effort: ["low", "medium", "high"]
+      },
+      "gemini-flash": {
+        displayName: "Gemini Flash",
+        resolve: "vercel/google/gemini-3.6-flash",
+        effort: ["minimal", "low", "medium", "high"]
+      },
+      "deepseek-pro": {
+        displayName: "DeepSeek Pro",
+        resolve: "vercel/deepseek/deepseek-v4-pro-0813",
+        effort: ["high", "xhigh"]
+      },
+      "deepseek-flash": {
+        displayName: "DeepSeek Flash",
+        resolve: "vercel/deepseek/deepseek-v4-flash",
+        effort: ["high", "xhigh"]
+      },
+      glm: {
+        displayName: "GLM",
+        resolve: "vercel/zai/glm-5.3",
+        effort: ["low", "high", "max"]
+      },
+      "kimi-k3": {
+        displayName: "Kimi K3",
+        resolve: "vercel/moonshotai/kimi-k3"
+      }
+    }
   })
 };
 function parseModel(slug) {
@@ -1498,6 +1699,9 @@ function formatModelLabel(params) {
   if (params.fallbackFrom) {
     return `${base} (credentials for ${providerDisplayName(params.fallbackFrom)} were rejected by the provider)`;
   }
+  if (params.clamped?.reason === "trial") {
+    return `${base} (free trial)`;
+  }
   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)`;
@@ -1507,6 +1711,15 @@ function formatModelLabel(params) {
   }
   return base;
 }
+function buildTrialDisclosure(owner) {
+  const consoleUrl = owner ? `https://pullfrog.com/console/${owner}` : "https://pullfrog.com/console";
+  return [
+    "---",
+    "",
+    "> [!IMPORTANT]",
+    `> **This run used the free trial model.** \`DeepSeek Flash\` is fast and cheap \u2014 expect lighter work than a frontier model. [Connect a subscription or API key \u2192](${consoleUrl})`
+  ].join("\n");
+}
 function buildPullfrogFooter(params) {
   const parts = [];
   if (params.shaPinned) {
@@ -1539,10 +1752,13 @@ function buildPullfrogFooter(params) {
     );
   }
   const allParts = [...parts, "[\u{1D54F}](https://x.com/pullfrogai)"];
+  const disclosure = params.clamped?.reason === "trial" ? `${buildTrialDisclosure(params.owner)}
+
+` : "";
   return `
 
 ${PULLFROG_DIVIDER}
-<sup>${FROG_LOGO}&nbsp;&nbsp;\uFF5C ${allParts.join(" \uFF5C ")}</sup>`;
+${disclosure}<sup>${FROG_LOGO}&nbsp;&nbsp;\uFF5C ${allParts.join(" \uFF5C ")}</sup>`;
 }
 function stripExistingFooter(body) {
   const dividerIndex = body.indexOf(PULLFROG_DIVIDER);
@@ -2093,6 +2309,7 @@ export {
   OSS_RECOMMENDED_MODEL,
   PULLFROG_DIVIDER,
   RUN_STATUS_CHECK_NAME,
+  SUBSIDY_RUNG,
   TIMEOUT_DISABLED,
   buildPullfrogFooter,
   commercialPaywallBody,

package/dist/models.d.ts

@@ -120,6 +120,7 @@ export declare const providers: {
     xai: ProviderConfig;
     deepseek: ProviderConfig;
     moonshotai: ProviderConfig;
+    "kimi-for-coding": ProviderConfig;
     opencode: ProviderConfig;
     "opencode-go": ProviderConfig;
     bedrock: ProviderConfig;
@@ -127,6 +128,7 @@ export declare const providers: {
     azure: ProviderConfig;
     "openai-compatible": ProviderConfig;
     openrouter: ProviderConfig;
+    vercel: ProviderConfig;
 };
 export type ModelProvider = keyof typeof providers;
 export declare function parseModel(slug: string): {

package/dist/toolState.d.ts

@@ -144,7 +144,7 @@ export interface ToolState {
     unselectedProxyDefault?: boolean | undefined;
     modelClamped?: {
         from: string;
-        reason: "card" | "noRouterPath" | "oss";
+        reason: "card" | "noRouterPath" | "oss" | "trial";
     } | undefined;
     shaPinned?: boolean | undefined;
     oss?: boolean | undefined;

package/dist/utils/apiKeys.d.ts

@@ -49,6 +49,25 @@ export declare const ROUTER_UNFUNDED_MARKER = "your Pullfrog Router balance is e
  * hand that agent the ability to suppress every other error body.
  */
 export declare const CREDENTIAL_REJECTED_MARKER = "was rejected by its provider";
+/**
+ * Three ways to arrive at "the runner has no key", each with a different CTA:
+ * we couldn't read the key you stored, your Router wallet ran dry and you have
+ * no key of your own, or you genuinely have no key. Every throw site picks by
+ * these flags.
+ */
+/**
+ * Nothing in the environment can pay for this run — as distinct from a
+ * credential that IS configured but incompletely (the Bedrock/Vertex/Azure/
+ * OpenAI-compatible setup validators), an agent that could not start
+ * (`getModelsFailure`), or Pullfrog failing to hand its own secrets over.
+ *
+ * The trial fallback keys on this class, and that is the whole reason it
+ * exists: every other failure in `validateAgentApiKey` means the user HAS
+ * brought a key, so falling back would swap their model for a cheap one and
+ * swallow the message telling them what to fix.
+ */
+export declare class NoUsableCredentialError extends Error {
+}
 /**
  * Validate that the resolved model can actually be served by the chosen
  * agent. For routing slugs (Bedrock / Vertex) the auth shape is multi-var
@@ -135,6 +154,21 @@ export declare function isMalformedKeyError(text: string): boolean;
  * user controls fixes it, so it gets its own copy instead of the re-auth CTA.
  */
 export declare function isClaudeSubscriptionDisabledError(text: string): boolean;
+/**
+ * Kimi Code entitlement denial — the key is valid and the membership is live,
+ * but the tier doesn't include the model or the context window the run asked
+ * for (`k3` and `k3-256k` need Moderato, `kimi-for-coding-highspeed` and K3's
+ * 1M window need Allegretto). Kimi answers all of them with **401**, the same
+ * status as a revoked key, so nothing but the sentence tells them apart — and
+ * without that the run renders "rotate the key in your provider dashboard",
+ * which names three things that will not fix it.
+ *
+ * Both published shapes, parameterised over the clause that varies rather than
+ * the model id inside it, per `isOAuthCredentialExpiredError`. Listed in
+ * `isApiKeyAuthError` below so the branch is reachable whatever `type` Kimi
+ * puts in the payload. See wiki/kimi-code.md.
+ */
+export declare function isKimiPlanTierError(text: string): boolean;
 export declare function isClaudeSessionLimitError(text: string): boolean;
 /**
  * The provider rejected a credential we checked before the agent started, and

package/dist/utils/billingErrors.d.ts

@@ -9,8 +9,7 @@
  * Actions job summary and the PR progress comment.
  *
  * Lives outside `main.ts` so adding a new error `code` branch is a one-file
- * edit that does not retrigger the full LLM CI matrix (`action/main.ts` is
- * in `action/test/coverage.ts::ALWAYS_RUN_ALL`).
+ * edit rather than an orchestrator edit (see wiki/main.md).
  */
 /**
  * Billing-layer error surfaced from `/api/proxy-token` as a 402. User-actionable,

package/dist/utils/buildPullfrogFooter.d.ts

@@ -36,7 +36,7 @@ export interface BuildPullfrogFooterParams {
      */
     clamped?: {
         from: string;
-        reason: "card" | "noRouterPath" | "oss";
+        reason: "card" | "noRouterPath" | "oss" | "trial";
     } | undefined;
     /**
      * true when the run used the default proxy model only because no model was
@@ -57,6 +57,9 @@ export interface BuildPullfrogFooterParams {
      * with the phrase linking to the OSS application page.
      */
     oss?: boolean | undefined;
+    /** repo owner, used to deep-link the trial disclosure at that account's own
+     * console rather than the generic landing page. */
+    owner?: string | undefined;
 }
 /**
  * build a pullfrog footer with configurable parts

package/dist/utils/payload.d.ts

@@ -4,6 +4,7 @@ export declare const JsonPayload: import("arktype/internal/variants/object.ts").
     "~pullfrog": true;
     version: string;
     prompt: string;
+    type?: string | undefined;
     model?: string | undefined;
     modelExplicit?: boolean | undefined;
     effort?: string | number | undefined;

package/dist/utils/providerErrors.d.ts

@@ -2,6 +2,14 @@
 export declare const PROVIDER_BILLING_EXHAUSTED_LABEL = "provider billing exhausted";
 /** Stable label for "OpenRouter can route this model nowhere you permit". */
 export declare const PROVIDER_NO_ENDPOINTS_LABEL = "provider no routable endpoints";
+/**
+ * A SUBSCRIPTION usage window that has run out, which is deliberately NOT
+ * `PROVIDER_BILLING_EXHAUSTED_LABEL`: that label routes to a body whose CTA is
+ * "Top up your provider balance", and a capped ChatGPT or Zen plan has no
+ * balance to top up — it resets on its own. This label carries the cause into
+ * the headline and lets the generic body stand.
+ */
+export declare const PROVIDER_USAGE_LIMIT_LABEL = "provider usage limit reached";
 export declare function findAnthropicSpendCap(text: string): {
     regainAt: string | null;
 } | null;

package/dist/utils/proxy.d.ts

@@ -44,3 +44,27 @@ export declare function runProxyResolution(ctx: {
     };
     toolState: ToolState;
 }): Promise<void>;
+/**
+ * Late fallback for a run inside the no-card trial whose own key search came up
+ * dry. Mints a Pullfrog-funded key on the efficient tier so a new account's
+ * first run produces a review rather than a credentials error.
+ *
+ * Deliberately runs AFTER `validateAgentApiKey` rather than beside the ordinary
+ * proxy resolution: the server grants permission but cannot see workflow `env:`
+ * keys, so only the runner knows whether anything else could have paid. Minting
+ * eagerly would silently downgrade every account whose key lives in GitHub
+ * Actions secrets.
+ *
+ * Returns false when the mint is unavailable (no OIDC, server declined), leaving
+ * the caller to raise the original missing-key error unchanged.
+ */
+export declare function resolveTrialFallback(ctx: {
+    payload: ResolvedPayload;
+    configuredModel: string | undefined;
+    oidcCredentials: OidcCredentials | null;
+    repo: {
+        owner: string;
+        name: string;
+    };
+    toolState: ToolState;
+}): Promise<boolean>;

package/dist/utils/runContext.d.ts

@@ -87,6 +87,10 @@ export interface RunContext {
      * funding state. see wiki/billing.md.
      */
     routerUnfunded?: boolean | undefined;
+    /** the account is inside its no-card trial and nothing else could fund this
+     * run — the runner may mint a subsidized efficient-tier key if, and only if,
+     * its own key search comes up dry. see the run-context route. */
+    trialFallback?: boolean | undefined;
 }
 /**
  * fetch run context from Pullfrog API
@@ -97,4 +101,7 @@ export declare function fetchRunContext(params: {
     token: string;
     repoContext: RepoContext;
     oidcToken?: string | undefined;
+    /** `payload.type` — lets the server apply this repo's per-trigger model
+     * override, which it cannot derive from owner/repo alone. */
+    runType?: string | undefined;
 }): Promise<RunContext>;

package/dist/utils/runContextData.d.ts

@@ -20,10 +20,19 @@ export interface RunContextData {
     /** the Router was declined because the wallet is empty. see
      * `RunContext.routerUnfunded`. */
     routerUnfunded?: boolean | undefined;
+    /** the account is inside its no-card trial and nothing else could fund this
+     * run, so the runner MAY mint a subsidized key on the efficient tier if its
+     * own key search comes up dry. a permission, not a routing decision — the
+     * server cannot see workflow `env:` keys. see `RunContext.trialFallback`. */
+    trialFallback?: boolean | undefined;
 }
 interface ResolveRunContextDataParams {
     octokit: OctokitWithPlugins;
     token: string;
+    /** the dispatch payload's run type, read before the payload is resolved
+     * because run-context is fetched first and needs it to pick this trigger's
+     * model override. */
+    runType?: string | undefined;
 }
 /**
  * true when the action is pinned to a full commit SHA (vs the moving `@v0`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pullfrog",
-  "version": "0.1.66",
+  "version": "0.1.68",
   "type": "module",
   "bin": {
     "pullfrog": "dist/cli.mjs",