@alumbwe/anvil 1.0.20 → 1.0.21

package/vendor/@anvil/common/src/constants/provider-routes.ts

@@ -0,0 +1,317 @@
+export const PROVIDER_ROUTE_IDS = [
+  'fireworks/deployment',
+  'fireworks/serverless',
+  'minimax/official',
+  'xiaomi/official',
+  'openrouter/novita/fp8',
+  'mimo/openrouter',
+  'infron/makora',
+  'deepseek/openrouter',
+  'deepseek/crof',
+  'deepseek/official',
+] as const
+
+export type ProviderRouteId = (typeof PROVIDER_ROUTE_IDS)[number]
+
+export const FIREWORKS_DEPLOYMENT_PROVIDER_ROUTE =
+  'fireworks/deployment' satisfies ProviderRouteId
+export const FIREWORKS_SERVERLESS_PROVIDER_ROUTE =
+  'fireworks/serverless' satisfies ProviderRouteId
+export const MINIMAX_OFFICIAL_PROVIDER_ROUTE =
+  'minimax/official' satisfies ProviderRouteId
+/**
+ * Marks a MiMo session as diverted off Xiaomi's direct API to the OpenRouter
+ * lane. Like {@link DEEPSEEK_INFRON_MAKORA_PROVIDER_ROUTE} it says *that* the
+ * session is on the fallback, NOT which upstream serves it — that is
+ * {@link MIMO_OPENROUTER_UPSTREAM} below, so repointing it also moves every
+ * session already pinned here, with no migration.
+ *
+ * Named generically on purpose. Its predecessor
+ * {@link MIMO_NOVITA_PROVIDER_ROUTE} baked the upstream into a value that gets
+ * persisted in `free_session.provider_route` and read back unvalidated, so
+ * changing upstreams meant either a migration or a name that lies.
+ */
+export const MIMO_OPENROUTER_PROVIDER_ROUTE =
+  'mimo/openrouter' satisfies ProviderRouteId
+/**
+ * The upstreams that serve {@link MIMO_OPENROUTER_PROVIDER_ROUTE}, preferred
+ * first: Xiaomi's OWN endpoint, reached through OpenRouter's account rather
+ * than our direct API key, with Novita behind it purely as depth.
+ *
+ * It lives next to the route id because the two are meant to be read together —
+ * the id says which lane a session is pinned to, this says who serves it — and
+ * in `common/` rather than in mimo-router.ts so `scripts/mimo-smoke.ts` can
+ * assert against the REAL value without importing the billing chain. A smoke
+ * test that restates this config would keep passing after the upstream moved,
+ * reporting a lane it no longer covers.
+ *
+ * Novita served the lane until 2026-08-01, which was most of what made the
+ * fallback expensive. Measured over 6h of prod that day, attributing rows by
+ * whether their cost reproduces our Xiaomi formula:
+ *
+ *   openrouter/novita   18,268 reqs (42.6%)  19.2% cache  $364.11  $0.138/M in
+ *   xiaomi direct       24,631 reqs (57.4%)  90.5% cache   $63.76  $0.018/M in
+ *
+ * Novita is also 20% dearer per token before caching ($0.168/$0.336 against
+ * Xiaomi's $0.14/$0.28) and prices cache reads at $0.0034/M against $0.0028/M.
+ * Xiaomi's OpenRouter endpoint is priced identically to our direct rate, so the
+ * lane costs the same as the primary and differs only in whose rate limit and
+ * prompt cache it draws on — which is the entire point of having it.
+ */
+export const MIMO_OPENROUTER_UPSTREAM_ORDER = [
+  'xiaomi/fp8',
+  'novita/fp8',
+] as const
+
+/**
+ * Fresh OpenRouter `provider` block for the MiMo lane.
+ *
+ * TWO ENTRIES DELIBERATELY, and it must never go back to one. A pinned session
+ * has no health check and no un-pin path — `routeWithStickyFallback` short
+ * -circuits straight to the fallback — so if the lane's only upstream is down,
+ * one transient Xiaomi blip wedges every remaining request in that session
+ * rather than degrading a single one. That is not hypothetical: a one-deep pin
+ * on DeepSeek's Infron lane took out 1,160 requests across 191 users for ~32h
+ * when `makora` went offline (2026-07-26/27, fixed in #1045).
+ *
+ * Verified live on this lane 2026-08-01: within an `allow_fallbacks:false`
+ * order list, an unroutable first entry is SKIPPED rather than failing the
+ * request — `order:['nosuchprovider','xiaomi/fp8']` returned 200 from Xiaomi —
+ * while `order:['xiaomi/fp8','novita/fp8']` still serves from Xiaomi when it is
+ * healthy. So the depth costs nothing in the normal case and is the difference
+ * between a degraded session and a wedged one in the bad case. Novita is second
+ * because it is the best-understood host for this model: it served ~43% of MiMo
+ * traffic through late July, so its compatibility with our request shape is
+ * proven, and it only ever serves when Xiaomi cannot.
+ *
+ * Returns a NEW object with a NEW array every call. These arrays get aliased
+ * into an outgoing request body, and this file's peer
+ * `INFRON_PROVIDER_ORDER` was made copy-on-assignment in #1045 for exactly that
+ * reason — one downstream mutation would corrupt routing process-wide.
+ */
+export function mimoOpenRouterProvider(): Record<string, unknown> {
+  return {
+    order: [...MIMO_OPENROUTER_UPSTREAM_ORDER],
+    allow_fallbacks: false,
+  }
+}
+/**
+ * LEGACY MiMo fallback pin, written while the OpenRouter lane was hardcoded to
+ * Novita FP8. Still recognized on READ so sessions pinned before
+ * {@link MIMO_OPENROUTER_PROVIDER_ROUTE} shipped keep serving from the fallback
+ * instead of silently reverting to a Xiaomi-direct attempt they already failed.
+ * Never written anymore; expires with its session.
+ */
+export const MIMO_NOVITA_PROVIDER_ROUTE =
+  'openrouter/novita/fp8' satisfies ProviderRouteId
+/**
+ * DeepSeek V4 Flash's CrofAI lane — and, since the 2026-08-15 cutover, the
+ * COHORT MARK that says a session belongs on it.
+ *
+ * This id now carries two meanings that deliberately coincide. Written at
+ * ADMISSION it means "this session was admitted after the cutover, so it enters
+ * the cascade on CrofAI". Written by the CASCADE it means "this session
+ * diverted onto CrofAI". Both want the same thing — enter on CrofAI — which is
+ * why pins written by the pre-cutover code needed no migration when the
+ * cutover shipped, and why nothing has to distinguish them on read.
+ *
+ * A session with NO pin is, by construction, one admitted before the cutover
+ * shipped: it runs the pre-cutover order and keeps the prompt cache it has
+ * already paid to warm. See `deepseekEntryLane` and
+ * docs/anvil-deepseek-provider-cutover.md.
+ *
+ * Reference prices, from live billing 2026-08-04, per M:
+ *
+ *                   input    cache read   output
+ *   CrofAI 0731     0.1200     0.0030     0.2100
+ *   Infron alibaba  0.0690     0.0144     0.1375
+ *   OpenRouter      0.0881     0.0176     0.1761
+ *   DeepSeek direct 0.1400     0.0028     0.2800
+ *
+ * CrofAI is DEARER on fresh input and output and cheaper than everything except
+ * DeepSeek direct on cache reads — but a coding turn re-sends its whole prefix
+ * every step, so cache reads are most of the tokens and that is the term that
+ * decides the bill. Against Infron, 0.0030 vs 0.0144 is a 4.8x cut on the
+ * dominant term; break-even is around an 82% cache-hit rate, which a
+ * sticky-pinned session clears comfortably and a single cold turn does not.
+ * That is the trade this ordering makes, and it is why the ordering would be
+ * wrong if these lanes were not sticky.
+ *
+ * It also serves `deepseek-v4-flash-0731` — the GA build, the same one
+ * DeepSeek's own API serves — where Infron's undated slug is a frozen preview
+ * snapshot. So this lane matches the DeepSeek-direct lane behind it in
+ * behaviour as well as price.
+ */
+export const DEEPSEEK_CROF_PROVIDER_ROUTE =
+  'deepseek/crof' satisfies ProviderRouteId
+/**
+ * DeepSeek's own API — the lane a cutover session diverts to, and the lane
+ * every PRE-cutover session still enters on.
+ *
+ * It was the unpinned default until 2026-08-15, which is why it had no route id
+ * before: a lane nothing ever moves to needs no name. Now that a cutover
+ * session can divert here, it has to be able to say so, and to stay — its
+ * prompt cache is warm on this upstream, and sending the next turn back to a
+ * CrofAI that just failed would pay a cold prefill to reach a lane we already
+ * know is unhealthy. The pin skips CrofAI as an ENTRY point only: it stays in
+ * the order behind this lane, because by the next turn the blip has usually
+ * cleared and CrofAI is still far cheaper than Infron.
+ *
+ * Behind CrofAI for cutover sessions despite the marginally better cache-read
+ * price ($0.0028/M against $0.0030/M) because DeepSeek is the side that
+ * repriced, and because of the
+ * failure record that made this a cascade at all: on 2026-08-03/04 it shed peak
+ * load with 3,934 x 503 "Service is too busy" and diverted 4,997 sessions at
+ * once, and on 2026-08-11 it accepted 650 requests in six hours and then sent
+ * nothing, tripping the four-minute first-token watchdog. Note that the
+ * watchdog is DeepSeek-direct-only (see `handleDeepSeekStream`); no equivalent
+ * guards the CrofAI lane now serving in front of it.
+ */
+export const DEEPSEEK_OFFICIAL_PROVIDER_ROUTE =
+  'deepseek/official' satisfies ProviderRouteId
+/**
+ * DeepSeek V4 Flash's LAST resort: the Infron lane, tier 3 of THREE.
+ *
+ * It gets ONE attempt and leaves no resumable pin (see `asDeepSeekLane`): its
+ * cache reads are 4.8x CrofAI's, so a session must never settle here.
+ *
+ * Ordering is deliberate and was arrived at the hard way. Infron is the
+ * cheapest route we have for this model — measured live 2026-08-04 on a
+ * 45,008-token prompt, $0.069/M input and ~$0.0144/M cache read against the
+ * OpenRouter lane's $0.0881 and $0.0176, so ~22% cheaper cold and ~13% warm.
+ * But it is a single aggregator account behind one Alibaba provider group, and
+ * when 4,997 sessions diverted onto it in one window it returned 13,286
+ * saturation 429s and then ran out of credits entirely.
+ *
+ * So it sits behind {@link DEEPSEEK_CROF_PROVIDER_ROUTE} and {@link
+ * DEEPSEEK_OFFICIAL_PROVIDER_ROUTE}: cheapest on FRESH input, which is what a
+ * cold session pays, while the two lanes ahead of it win the warm case on cache
+ * reads, and it must never be the lane a session settles on. This only works
+ * because the cascade RE-PINS on each hop — a session that finds Infron
+ * saturated does not pay a doomed Infron attempt on every later turn.
+ *
+ * The `makora` in the name is historical (that upstream went offline in
+ * 2026-07). The id says only *that* a session is on this lane, never which
+ * upstream serves it — that is INFRON_PROVIDER_ORDER, keyed by model — so
+ * repointing the upstream also moves sessions already pinned here. Renaming the
+ * value itself would need a migration; it is persisted in
+ * `free_session.provider_route` and read back unvalidated.
+ */
+export const DEEPSEEK_INFRON_MAKORA_PROVIDER_ROUTE =
+  'infron/makora' satisfies ProviderRouteId
+/**
+ * RETIRED as a DeepSeek lane on 2026-08-11. Kept as a recognized id because it
+ * is persisted in `free_session.provider_route` and read back unvalidated —
+ * sessions still carrying the pin must not crash; they simply start from the
+ * primary again, which is the right answer for a lane that no longer exists.
+ *
+ * Why it went: it prices cache reads at $0.0176/M against CrofAI's $0.0030,
+ * and an agent turn re-sends its whole prefix every step, so ~98% of the
+ * tokens land on exactly that term. Being "last resort" did not bound the
+ * damage — the pin only moved forward, so one transient 429 on the lane above
+ * parked a session here for the rest of its hour. It was reached 1,205 times
+ * in 24h, more often than the lane ahead of it, and DeepSeek's daily bill went
+ * from $9k to $39.7k over four days while volume rose only 41%. Depth that
+ * costs 5.9x on the dominant token class is not depth.
+ *
+ * The replacement for that depth is retries: the two cheap lanes are attempted
+ * three times each before anything diverts.
+ *
+ * (Historical, for the MiMo lane which still uses OpenRouter:)
+ * DeepSeek V4 Flash's LAST resort: the OpenRouter lane, tier 4 of four.
+ *
+ * Reached when DeepSeek direct and then {@link
+ * DEEPSEEK_INFRON_MAKORA_PROVIDER_ROUTE} have both failed retryably. Dearer per
+ * token than Infron but backed by many independent upstreams and a balance that
+ * is not one account's, which is exactly what a divert storm needs — see the
+ * Infron route's doc for why the cheap lane cannot be the last one.
+ *
+ * Like its MiMo peer it names the LANE, not the upstream — that is {@link
+ * DEEPSEEK_OPENROUTER_UPSTREAM_ORDER} below, so repointing the order also moves
+ * every session already pinned here, with no migration.
+ */
+export const DEEPSEEK_OPENROUTER_PROVIDER_ROUTE =
+  'deepseek/openrouter' satisfies ProviderRouteId
+/**
+ * The upstreams that serve {@link DEEPSEEK_OPENROUTER_PROVIDER_ROUTE},
+ * preferred first.
+ *
+ * Chosen as *cheapest that still preserves the prompt cache*, which for an
+ * agent workload are not the same axis. Cache-read price is what actually
+ * drives this bill — a coding turn re-sends a long prefix every step, so most
+ * input tokens are cache reads — and the OpenRouter catalog splits cleanly on
+ * it (checked live 2026-08-04, per M):
+ *
+ *   streamlake/fp8   $0.0881 in  $0.0176 cache  $0.1761 out  fp8   384k max out
+ *   baidu/fp8        $0.0882 in  $0.0176 cache  $0.1764 out  fp8   131k max out
+ *   gmicloud/fp8     $0.0938 in  $0.0188 cache  $0.1876 out  fp8   no stated cap
+ *   ── everything below is >=1.5x the cache-read price ──
+ *   most of the tail  $0.14   in  $0.0280 cache  $0.2800 out
+ *   parasail/coreweave/phala     $0.0700 cache  (4x)
+ *   morph, mancer/fp4            NO cache read at all
+ *
+ * So the three cheapest on input are also the three cheapest on cache read;
+ * there is no tradeoff to make here, which is why the list is short.
+ *
+ * DELIBERATELY NOT `deepseek` (OpenRouter's DeepSeek-first-party endpoint).
+ * It has by far the best cache read ($0.0028/M) and is tempting for that alone,
+ * but it is the same upstream whose failure triggers this fallback, reached
+ * through a middleman — pointing the lane there would divert an outage onto
+ * itself. The Infron lane can use the 0731 model without this problem because
+ * it pins independent Alibaba upstreams.
+ *
+ * `deepinfra/fp4` is skipped despite sitting third on price: fp4 quantization,
+ * and a 65,536-token output cap that would truncate long agent turns. fp8 is
+ * the floor for this lane.
+ *
+ * THREE ENTRIES, and it must never go to one — see the identical warning on
+ * {@link mimoOpenRouterProvider}. A pinned session has no health check and no
+ * un-pin path, so a one-deep lane turns a single upstream blip into a wedged
+ * session. That is not hypothetical here: this model's previous fallback was
+ * pinned one-deep to `makora` and took out 1,160 requests across 191 users for
+ * ~32h when it went offline (2026-07-26/27, #1045).
+ *
+ * Caveat on the third entry: `gmicloud/fp8` does not list `stop` in its
+ * supported parameters. Without `require_parameters` OpenRouter drops the
+ * unsupported field rather than refusing to route, so a turn served there does
+ * not honor the global stop sequence. Accepted for depth — it only serves when
+ * both fp8 upstreams above it are unavailable — but do not promote it.
+ */
+export const DEEPSEEK_OPENROUTER_UPSTREAM_ORDER = [
+  'streamlake/fp8',
+  'baidu/fp8',
+  'gmicloud/fp8',
+] as const
+
+/**
+ * The OpenRouter output cap this lane requests.
+ *
+ * Matches `streamlake/fp8`'s 384,000-token ceiling — the first upstream in the
+ * order — so a caller's explicit budget can never make the preferred endpoint
+ * ineligible. Slightly under DeepSeek direct's 393,216, same as the Infron lane
+ * this replaces: keep fallback requests inside the contract of the route that
+ * will actually serve them.
+ */
+export const DEEPSEEK_OPENROUTER_MAX_TOKENS = 384_000
+
+/**
+ * Fresh OpenRouter `provider` block for the DeepSeek V4 Flash lane.
+ *
+ * Returns a NEW object with a NEW array every call — these arrays get aliased
+ * into an outgoing request body, and one downstream mutation would corrupt
+ * routing process-wide (the bug `INFRON_PROVIDER_ORDER` was made
+ * copy-on-assignment for in #1045).
+ *
+ * `allow_fallbacks: false` is what preserves the prompt cache: it holds the
+ * session to this order instead of letting OpenRouter spread turns across
+ * twenty endpoints that each keep their own cache. Cache fragmentation is the
+ * expensive failure mode, not a slightly dearer per-token rate — measured on
+ * the MiMo lane, a scattered fallback averaged 27.6k cache_read against ~150k
+ * prompts, paying a full cold prefill per divert.
+ */
+export function deepseekOpenRouterProvider(): Record<string, unknown> {
+  return {
+    order: [...DEEPSEEK_OPENROUTER_UPSTREAM_ORDER],
+    allow_fallbacks: false,
+  }
+}

package/vendor/@anvil/common/src/constants/reasoning-effort.ts

@@ -0,0 +1,79 @@
+/**
+ * The one reasoning-effort vocabulary, shared by every surface.
+ *
+ * This list started in `anvil-desktop/src/shared/types.ts`, where it drives
+ * the Claude Code and Codex effort pickers. It lives here now so the Anvil
+ * model catalog and Desktop speak the same words: Desktop re-exports these,
+ * so a value persisted on a Desktop thread and a value on a Anvil catalog
+ * row are the same strings, comparable without a translation table.
+ *
+ * ORDERED, ascending, and that order is load-bearing — `clampReasoningEffort`
+ * does index arithmetic on it to answer "the most effort this model allows,
+ * but no more than was asked for". Keep it strictly ascending.
+ *
+ * Not every rung reaches every provider. `ultra` exists only for local CLI
+ * harnesses; Meta tops out at `xhigh`, while both DeepSeek V4 models expose
+ * `low`/`high`/`max` and nothing between. What a given model actually offers is
+ * its own `efforts` array, and the clamp stops one model's rung reaching
+ * another's API.
+ */
+export const REASONING_EFFORTS = [
+  'minimal',
+  'low',
+  'medium',
+  'high',
+  'xhigh',
+  'max',
+  'ultra',
+] as const
+
+export type ReasoningEffort = (typeof REASONING_EFFORTS)[number]
+
+/** Kept explicit so a picker and a turn agree, rather than each deferring to
+ *  some CLI's own default. */
+export const DEFAULT_REASONING_EFFORT: ReasoningEffort = 'high'
+
+export function isReasoningEffort(value: unknown): value is ReasoningEffort {
+  return REASONING_EFFORTS.includes(value as ReasoningEffort)
+}
+
+/** Position on the shared ladder, or -1. Exported for tests that assert one
+ *  rung sits below another without hard-coding the list. */
+export function reasoningEffortRank(value: unknown): number {
+  return REASONING_EFFORTS.indexOf(value as ReasoningEffort)
+}
+
+/**
+ * The highest rung `allowed` offers that is no higher than `requested`.
+ *
+ * Clamp-DOWN, not "reject and fall back", and the difference matters. A user on
+ * Muse Spark's `xhigh` whose request is rerouted to a model topping out at
+ * `high` should land on `high` — the closest thing to what they asked for —
+ * rather than snapping back to that model's default, which could be lower.
+ * When `requested` is below everything on offer, the lowest rung wins; when it
+ * is absent or unrecognized, the caller's fallback does.
+ */
+export function clampReasoningEffort(
+  requested: unknown,
+  allowed: readonly ReasoningEffort[],
+  fallback: ReasoningEffort,
+): ReasoningEffort {
+  if (allowed.length === 0) return fallback
+  if (!isReasoningEffort(requested)) return fallback
+
+  const wanted = reasoningEffortRank(requested)
+  let best: ReasoningEffort | undefined
+  for (const candidate of allowed) {
+    const rank = reasoningEffortRank(candidate)
+    if (rank > wanted) continue
+    if (best === undefined || rank > reasoningEffortRank(best)) best = candidate
+  }
+  if (best !== undefined) return best
+
+  // Everything on offer is above what was asked for: give the least of them.
+  return allowed.reduce((lowest, candidate) =>
+    reasoningEffortRank(candidate) < reasoningEffortRank(lowest)
+      ? candidate
+      : lowest,
+  )
+}

package/vendor/@anvil/common/src/constants/skills.ts

@@ -0,0 +1,60 @@
+/**
+ * Skills constants and validation rules.
+ *
+ * Skills are SKILL.md files with YAML frontmatter that define reusable
+ * instructions that agents can load on-demand via the skill tool.
+ */
+
+/**
+ * The directory name where skills are stored (within .agents/).
+ */
+export const SKILLS_DIR_NAME = 'skills'
+
+/**
+ * The file name for skill definitions.
+ */
+export const SKILL_FILE_NAME = 'SKILL.md'
+
+/**
+ * Validation regex for skill names.
+ * - 1-64 characters
+ * - Lowercase alphanumeric with single hyphen separators
+ * - Cannot start or end with hyphen
+ * - No consecutive hyphens
+ */
+export const SKILL_NAME_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/
+
+/**
+ * Maximum length for skill name.
+ */
+export const SKILL_NAME_MAX_LENGTH = 64
+
+/**
+ * Maximum length for skill description.
+ */
+export const SKILL_DESCRIPTION_MAX_LENGTH = 1024
+
+/**
+ * Validates a skill name according to the naming rules.
+ * @param name - The skill name to validate
+ * @returns true if valid, false otherwise
+ */
+export function isValidSkillName(name: string): boolean {
+  if (!name || name.length > SKILL_NAME_MAX_LENGTH) {
+    return false
+  }
+  return SKILL_NAME_REGEX.test(name)
+}
+
+/**
+ * Validates a skill description according to length rules.
+ * @param description - The skill description to validate
+ * @returns true if valid, false otherwise
+ */
+export function isValidSkillDescription(description: string): boolean {
+  return (
+    typeof description === 'string' &&
+    description.length >= 1 &&
+    description.length <= SKILL_DESCRIPTION_MAX_LENGTH
+  )
+}

package/vendor/@anvil/common/src/constants/subscription-plans.ts

@@ -0,0 +1,49 @@
+export const SUBSCRIPTION_DISPLAY_NAME = 'Strong' as const
+
+export interface TierConfig {
+  monthlyPrice: number
+  creditsPerBlock: number
+  blockDurationHours: number
+  weeklyCreditsLimit: number
+}
+
+export const SUBSCRIPTION_TIERS = {
+  100: {
+    monthlyPrice: 100,
+    creditsPerBlock: 420,
+    blockDurationHours: 5,
+    weeklyCreditsLimit: 4200,
+  },
+  200: {
+    monthlyPrice: 200,
+    creditsPerBlock: 1050,
+    blockDurationHours: 5,
+    weeklyCreditsLimit: 10500,
+  },
+  500: {
+    monthlyPrice: 500,
+    creditsPerBlock: 2940,
+    blockDurationHours: 5,
+    weeklyCreditsLimit: 29400,
+  },
+} as const satisfies Record<number, TierConfig>
+
+export type SubscriptionTierPrice = keyof typeof SUBSCRIPTION_TIERS
+
+export const DEFAULT_TIER = SUBSCRIPTION_TIERS[200]
+
+export function createSubscriptionPriceMappings(priceIds: Record<SubscriptionTierPrice, string>) {
+  const priceToTier = Object.fromEntries(
+    Object.entries(priceIds).map(([tier, priceId]) => [priceId, Number(tier) as SubscriptionTierPrice]),
+  ) as Record<string, SubscriptionTierPrice>
+
+  function getTierFromPriceId(priceId: string): SubscriptionTierPrice | null {
+    return priceToTier[priceId] ?? null
+  }
+
+  function getPriceIdFromTier(tier: SubscriptionTierPrice): string | null {
+    return priceIds[tier] ?? null
+  }
+
+  return { getTierFromPriceId, getPriceIdFromTier }
+}

package/vendor/@anvil/common/src/constants/ui.ts

@@ -0,0 +1,25 @@
+export const AuthState = {
+  LOGGED_OUT: 'LOGGED_OUT',
+  LOGGED_IN: 'LOGGED_IN',
+} as const
+
+export type AuthState = (typeof AuthState)[keyof typeof AuthState]
+
+export const UserState = {
+  LOGGED_OUT: 'LOGGED_OUT',
+  GOOD_STANDING: 'GOOD_STANDING', // >= 100 credits
+  ATTENTION_NEEDED: 'ATTENTION_NEEDED', // 20-99 credits
+  CRITICAL: 'CRITICAL', // 1-19 credits
+  DEPLETED: 'DEPLETED', // <= 0 credits
+} as const
+
+export type UserState = (typeof UserState)[keyof typeof UserState]
+
+export function getUserState(isLoggedIn: boolean, credits: number): UserState {
+  if (!isLoggedIn) return UserState.LOGGED_OUT
+
+  if (credits >= 100) return UserState.GOOD_STANDING
+  if (credits >= 20) return UserState.ATTENTION_NEEDED
+  if (credits >= 1) return UserState.CRITICAL
+  return UserState.DEPLETED
+}

package/vendor/@anvil/common/src/env-ci.ts

@@ -0,0 +1,36 @@
+/**
+ * CI environment helper for dependency injection.
+ *
+ * This module provides a typed interface to CI-specific environment variables.
+ * These are used in CI/CD pipelines and eval contexts.
+ * In tests, use `@anvil/common/testing-env-ci`.
+ */
+
+import type { CiEnv } from './types/contracts/env'
+
+/**
+ * Get CI environment values.
+ * Returns a snapshot of the current process.env values for CI-specific vars.
+ */
+export const getCiEnv = (): CiEnv => ({
+  CI: process.env.CI,
+  GITHUB_ACTIONS: process.env.GITHUB_ACTIONS,
+  RENDER: process.env.RENDER,
+  IS_PULL_REQUEST: process.env.IS_PULL_REQUEST,
+  ANVIL_GITHUB_TOKEN: process.env.ANVIL_GITHUB_TOKEN,
+  ANVIL_API_KEY: process.env.ANVIL_API_KEY,
+})
+
+/**
+ * Default CI env instance.
+ * Use this for production code, inject mocks in tests.
+ */
+export const ciEnv: CiEnv = getCiEnv()
+
+/**
+ * Check if running in CI environment
+ */
+export const isCI = (): boolean => {
+  const env = getCiEnv()
+  return env.CI === 'true' || env.CI === '1' || env.GITHUB_ACTIONS === 'true'
+}

package/vendor/@anvil/common/src/env-process.ts

@@ -0,0 +1,95 @@
+/**
+ * Process environment helper for dependency injection.
+ *
+ * This module provides a typed interface to process.env values that aren't
+ * part of our validated schemas (ClientEnv/ServerEnv). These are runtime
+ * environment variables like SHELL, HOME, TERM, etc.
+ *
+ * Usage:
+ * - Import `getBaseEnv` for base OS-level vars only
+ * - Import `getProcessEnv` for the full ProcessEnv (base + extensions)
+ * - In tests, use `@anvil/common/testing-env-process`
+ */
+
+import type { BaseEnv, ProcessEnv } from './types/contracts/env'
+
+/**
+ * Get base environment values (OS-level vars only).
+ * This is the foundation that package-specific helpers should spread into.
+ */
+export const getBaseEnv = (): BaseEnv => ({
+  SHELL: process.env.SHELL,
+  COMSPEC: process.env.COMSPEC,
+  HOME: process.env.HOME,
+  USERPROFILE: process.env.USERPROFILE,
+  APPDATA: process.env.APPDATA,
+  XDG_CONFIG_HOME: process.env.XDG_CONFIG_HOME,
+  TERM: process.env.TERM,
+  TERM_PROGRAM: process.env.TERM_PROGRAM,
+  TERM_BACKGROUND: process.env.TERM_BACKGROUND,
+  TERMINAL_EMULATOR: process.env.TERMINAL_EMULATOR,
+  COLORFGBG: process.env.COLORFGBG,
+  NODE_ENV: process.env.NODE_ENV,
+  NODE_PATH: process.env.NODE_PATH,
+  PATH: process.env.PATH,
+})
+
+/**
+ * Get full process environment values (base + all extensions).
+ * Returns a snapshot of the current process.env values for the ProcessEnv type.
+ */
+export const getProcessEnv = (): ProcessEnv => ({
+  ...getBaseEnv(),
+
+  // Terminal-specific
+  KITTY_WINDOW_ID: process.env.KITTY_WINDOW_ID,
+  SIXEL_SUPPORT: process.env.SIXEL_SUPPORT,
+  ZED_NODE_ENV: process.env.ZED_NODE_ENV,
+
+  // VS Code family detection
+  VSCODE_THEME_KIND: process.env.VSCODE_THEME_KIND,
+  VSCODE_COLOR_THEME_KIND: process.env.VSCODE_COLOR_THEME_KIND,
+  VSCODE_GIT_IPC_HANDLE: process.env.VSCODE_GIT_IPC_HANDLE,
+  VSCODE_PID: process.env.VSCODE_PID,
+  VSCODE_CWD: process.env.VSCODE_CWD,
+  VSCODE_NLS_CONFIG: process.env.VSCODE_NLS_CONFIG,
+
+  // Cursor editor detection
+  CURSOR_PORT: process.env.CURSOR_PORT,
+  CURSOR: process.env.CURSOR,
+
+  // JetBrains IDE detection
+  JETBRAINS_REMOTE_RUN: process.env.JETBRAINS_REMOTE_RUN,
+  IDEA_INITIAL_DIRECTORY: process.env.IDEA_INITIAL_DIRECTORY,
+  IDE_CONFIG_DIR: process.env.IDE_CONFIG_DIR,
+  JB_IDE_CONFIG_DIR: process.env.JB_IDE_CONFIG_DIR,
+
+  // Editor preferences
+  VISUAL: process.env.VISUAL,
+  EDITOR: process.env.EDITOR,
+  ANVIL_CLI_EDITOR: process.env.ANVIL_CLI_EDITOR,
+  ANVIL_EDITOR: process.env.ANVIL_EDITOR,
+
+  // Theme preferences
+  OPEN_TUI_THEME: process.env.OPEN_TUI_THEME,
+  OPENTUI_THEME: process.env.OPENTUI_THEME,
+
+  // Anvil CLI-specific
+  ANVIL_IS_BINARY: process.env.ANVIL_IS_BINARY,
+  ANVIL_CLI_VERSION: process.env.ANVIL_CLI_VERSION,
+  ANVIL_CLI_TARGET: process.env.ANVIL_CLI_TARGET,
+  ANVIL_RG_PATH: process.env.ANVIL_RG_PATH,
+  ANVIL_WASM_DIR: process.env.ANVIL_WASM_DIR,
+
+  // Build/CI flags
+  VERBOSE: process.env.VERBOSE,
+  OVERRIDE_TARGET: process.env.OVERRIDE_TARGET,
+  OVERRIDE_PLATFORM: process.env.OVERRIDE_PLATFORM,
+  OVERRIDE_ARCH: process.env.OVERRIDE_ARCH,
+})
+
+/**
+ * Default process env instance.
+ * Use this for production code, inject mocks in tests.
+ */
+export const processEnv: ProcessEnv = getProcessEnv()