@alumbwe/anvil 1.0.20 → 1.0.22

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

@@ -0,0 +1,15 @@
+/** Previous lightweight Gemini model. No agent still defaults to it, but
+ *  FREE_MODE_AGENT_MODELS keeps accepting it — released clients ship pinned
+ *  agent definitions and go on requesting it until their users upgrade. */
+export const GEMINI_3_1_FLASH_LITE_MODEL_ID = 'google/gemini-3.1-flash-lite'
+
+/** Current model for the lightweight Gemini helper subagents: basher,
+ *  browser-use, file-lister(-max), file-picker-max, and the researchers.
+ *  Pricier than 3.1 flash-lite ($0.30/$2.50 per M tokens vs $0.25/$1.50), and
+ *  those agents run millions of calls a month, so moving an agent onto it is a
+ *  real cost decision — not a free upgrade. */
+export const GEMINI_3_5_FLASH_LITE_MODEL_ID = 'google/gemini-3.5-flash-lite'
+
+/** Retired model ID emitted by Anvil clients released before July 2026. */
+export const LEGACY_GEMINI_3_1_FLASH_LITE_PREVIEW_MODEL_ID =
+  'google/gemini-3.1-flash-lite-preview'

package/vendor/@anvil/common/src/constants/grant-priorities.ts

@@ -0,0 +1,13 @@
+import type { GrantType } from '@anvil/common/types/grant'
+
+// Lower = consumed first
+export const GRANT_PRIORITIES: Record<GrantType, number> = {
+  subscription: 10,
+  free: 20,
+  referral_legacy: 30, // Legacy recurring referrals (renews monthly, consumed first)
+  ad: 40,
+  referral: 50, // One-time referrals (never expires, preserved longer)
+  admin: 60,
+  organization: 70,
+  purchase: 80,
+} as const

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

@@ -0,0 +1,6 @@
+/**
+ * Prod origin of the anvil.com web app (marketing site + browser sign-in).
+ * The CLI and Anvil Desktop both send users here for the device-code login
+ * flow; sharing the literal keeps their prod defaults from drifting.
+ */
+export const ANVIL_WEB_URL_PROD = 'https://anvil.com'

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

@@ -0,0 +1,51 @@
+/**
+ * Image-related constants shared across the codebase
+ */
+
+/**
+ * Extension to MIME type mapping for supported image formats
+ */
+export const IMAGE_EXTENSION_TO_MIME: Record<string, string> = {
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.png': 'image/png',
+  '.webp': 'image/webp',
+  '.gif': 'image/gif',
+  '.bmp': 'image/bmp',
+  '.tiff': 'image/tiff',
+  '.tif': 'image/tiff',
+}
+
+/**
+ * Supported image extensions (derived from IMAGE_EXTENSION_TO_MIME)
+ */
+export const SUPPORTED_IMAGE_EXTENSIONS = new Set(Object.keys(IMAGE_EXTENSION_TO_MIME))
+
+/**
+ * Check if a file extension is a supported image format
+ */
+export function isSupportedImageExtension(ext: string): boolean {
+  return SUPPORTED_IMAGE_EXTENSIONS.has(ext.toLowerCase())
+}
+
+/**
+ * Get MIME type for an image extension
+ */
+export function getImageMimeType(ext: string): string | null {
+  return IMAGE_EXTENSION_TO_MIME[ext.toLowerCase()] ?? null
+}
+
+/**
+ * Image extensions as a regex alternation pattern (without dots)
+ * e.g., "jpg|jpeg|png|webp|gif|bmp|tiff|tif"
+ */
+export const IMAGE_EXTENSIONS_PATTERN = Object.keys(IMAGE_EXTENSION_TO_MIME)
+  .map((ext) => ext.slice(1)) // Remove leading dot
+  .join('|')
+
+// Size limits for image uploads
+// Research shows Claude/GPT-4V support up to 20MB, but we use practical limits
+// for good performance and token efficiency
+export const MAX_IMAGE_FILE_SIZE = 10 * 1024 * 1024 // 10MB - allow larger files since we can compress
+export const MAX_IMAGE_BASE64_SIZE = 1 * 1024 * 1024 // 1MB max for base64 after compression
+export const MAX_TOTAL_IMAGE_SIZE = 5 * 1024 * 1024 // 5MB total for multiple images

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

@@ -0,0 +1,7 @@
+// Re-export all constants from domain-specific files for backwards compatibility
+// This allows existing imports from '@anvil/common/old-constants' to continue working
+
+export * from './model-config'
+export * from './limits'
+export * from './ui'
+export * from './paths'

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

@@ -0,0 +1,35 @@
+import path from 'path'
+
+export const KNOWLEDGE_FILE_NAMES = [
+  'AGENTS.md',
+  'CLAUDE.md',
+] as const
+
+/**
+ * Pre-computed lowercase knowledge file names for efficient matching.
+ */
+export const KNOWLEDGE_FILE_NAMES_LOWERCASE = KNOWLEDGE_FILE_NAMES.map((name) =>
+  name.toLowerCase(),
+)
+
+/**
+ * Checks if a file path is a knowledge file.
+ * Matches:
+ * - Exact file names: AGENTS.md, CLAUDE.md (case-insensitive)
+ * - Pattern: *.knowledge.md (e.g., authentication.knowledge.md)
+ */
+export function isKnowledgeFile(filePath: string): boolean {
+  const fileName = path.basename(filePath).toLowerCase()
+
+  // Check for exact matches with standard knowledge file names
+  if (KNOWLEDGE_FILE_NAMES_LOWERCASE.includes(fileName)) {
+    return true
+  }
+
+  // Check for *.knowledge.md pattern (e.g., authentication.knowledge.md)
+  if (fileName.endsWith('.knowledge.md')) {
+    return true
+  }
+
+  return false
+}

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

@@ -0,0 +1,23 @@
+export const PROFIT_MARGIN = 0.055
+
+export const REQUEST_CREDIT_SHOW_THRESHOLD = 1
+export const MAX_DATE = new Date(86399999999999)
+export const BILLING_PERIOD_DAYS = 30
+export const SESSION_MAX_AGE_SECONDS = 30 * 24 * 60 * 60 // 30 days
+export const SESSION_TIME_WINDOW_MS = 30 * 60 * 1000 // 30 minutes - used for matching sessions created around fingerprint creation
+// Signup credits are disabled. Re-enabling requires restoring the Anvil
+// GitHub-link hook and pricing copy in addition to changing this amount.
+export const SIGNUP_FREE_CREDITS_GRANT = 0
+// If re-enabled, signup credits require a GitHub account at least this old.
+export const SIGNUP_CREDIT_MIN_GITHUB_ACCOUNT_AGE_MONTHS = 4
+
+// New accounts do not receive monthly free credits; grandfathered monthly grants
+// are based on previous expiring free grants instead of this default.
+export const DEFAULT_FREE_CREDITS_GRANT = 0
+
+// Credit pricing configuration
+export const CREDIT_PRICING = {
+  CENTS_PER_CREDIT: 1, // 1 credit = 1 cent = $0.01
+  MIN_PURCHASE_CREDITS: 100, // $1.00 minimum
+  DISPLAY_RATE: '$0.01 per credit',
+} as const

package/vendor/@anvil/common/src/constants/model-config.ts

@@ -0,0 +1,277 @@
+// Allowed model prefixes for validation
+export const ALLOWED_MODEL_PREFIXES = [
+  'anthropic',
+  'openai',
+  'google',
+  'x-ai',
+  'deepseek',
+  'minimax',
+  'mimo',
+  'tencent',
+] as const
+
+export const costModes = [
+  'free',
+  'lite',
+  'normal',
+  'max',
+  'experimental',
+  'ask',
+] as const
+export type CostMode = (typeof costModes)[number]
+
+export const openaiModels = {
+  gpt4_1: 'gpt-4.1-2025-04-14',
+  gpt4o: 'gpt-4o-2024-11-20',
+  gpt4omini: 'gpt-4o-mini-2024-07-18',
+  o3mini: 'o3-mini-2025-01-31',
+  o3: 'o3-2025-04-16',
+  o3pro: 'o3-pro-2025-06-10',
+  o4mini: 'o4-mini-2025-04-16',
+  generatePatch:
+    'ft:gpt-4o-2024-08-06:manifold-markets:generate-patch-batch2:AKYtDIhk',
+} as const
+export type OpenAIModel = (typeof openaiModels)[keyof typeof openaiModels]
+
+export const openrouterModels = {
+  openrouter_claude_sonnet_4_5: 'anthropic/claude-sonnet-4.5',
+  openrouter_claude_sonnet_4: 'anthropic/claude-4-sonnet-20250522',
+  openrouter_claude_opus_4: 'anthropic/claude-opus-4.1',
+  openrouter_claude_3_5_haiku: 'anthropic/claude-3.5-haiku-20241022',
+  openrouter_claude_3_5_sonnet: 'anthropic/claude-3.5-sonnet-20240620',
+  openrouter_gpt4o: 'openai/gpt-4o-2024-11-20',
+  openrouter_gpt5: 'openai/gpt-5.1',
+  openrouter_gpt5_chat: 'openai/gpt-5.1-chat',
+  openrouter_gpt4o_mini: 'openai/gpt-4o-mini-2024-07-18',
+  openrouter_gpt4_1_nano: 'openai/gpt-4.1-nano',
+  openrouter_o3_mini: 'openai/o3-mini-2025-01-31',
+  openrouter_gemini2_5_pro_preview: 'google/gemini-2.5-pro',
+  openrouter_gemini2_5_flash: 'google/gemini-2.5-flash',
+  openrouter_gemini2_5_flash_thinking:
+    'google/gemini-2.5-flash-preview:thinking',
+  openrouter_grok_4: 'x-ai/grok-4-07-09',
+} as const
+export type openrouterModel =
+  (typeof openrouterModels)[keyof typeof openrouterModels]
+
+export const openCodeZenModels = {
+  opencode_kimi_k2_6: 'opencode/kimi-k2.6',
+} as const
+export type OpenCodeZenModel =
+  (typeof openCodeZenModels)[keyof typeof openCodeZenModels]
+
+export const deepseekModels = {
+  deepseekChat: 'deepseek-chat',
+  deepseekReasoner: 'deepseek-reasoner',
+  deepseekV4ProDirect: 'deepseek-v4-pro',
+  deepseekV4Pro: 'deepseek/deepseek-v4-pro',
+  deepseekV4FlashDirect: 'deepseek-v4-flash',
+  deepseekV4Flash: 'deepseek/deepseek-v4-flash',
+} as const
+export type DeepseekModel = (typeof deepseekModels)[keyof typeof deepseekModels]
+
+export const mimoModels = {
+  mimoV25Direct: 'mimo-v2.5',
+  mimoV25: 'mimo/mimo-v2.5',
+  mimoV25ProDirect: 'mimo-v2.5-pro',
+  mimoV25Pro: 'mimo/mimo-v2.5-pro',
+} as const
+export type MimoModel = (typeof mimoModels)[keyof typeof mimoModels]
+
+export const minimaxModels = {
+  minimaxM3: 'minimax/minimax-m3',
+} as const
+export type MiniMaxModel = (typeof minimaxModels)[keyof typeof minimaxModels]
+
+export const moonshotModels = {
+  kimiK26: 'moonshotai/kimi-k2.6',
+  kimiK27Code: 'moonshotai/kimi-k2.7-code',
+} as const
+export type MoonshotModel = (typeof moonshotModels)[keyof typeof moonshotModels]
+
+// Vertex uses "endpoint IDs" for finetuned models, which are just integers
+export const finetunedVertexModels = {
+  ft_filepicker_003: '196166068534771712',
+  ft_filepicker_005: '8493203957034778624',
+  ft_filepicker_007: '2589952415784501248',
+  ft_filepicker_topk_001: '3676445825887633408',
+  ft_filepicker_008: '2672143108984012800',
+  ft_filepicker_topk_002: '1694861989844615168',
+  ft_filepicker_010: '3808739064941641728',
+  ft_filepicker_010_epoch_2: '6231675664466968576',
+  ft_filepicker_topk_003: '1502192368286171136',
+} as const
+export const finetunedVertexModelNames: Record<string, string> = {
+  [finetunedVertexModels.ft_filepicker_003]: 'ft_filepicker_003',
+  [finetunedVertexModels.ft_filepicker_005]: 'ft_filepicker_005',
+  [finetunedVertexModels.ft_filepicker_007]: 'ft_filepicker_007',
+  [finetunedVertexModels.ft_filepicker_topk_001]: 'ft_filepicker_topk_001',
+  [finetunedVertexModels.ft_filepicker_008]: 'ft_filepicker_008',
+  [finetunedVertexModels.ft_filepicker_topk_002]: 'ft_filepicker_topk_002',
+  [finetunedVertexModels.ft_filepicker_010]: 'ft_filepicker_010',
+  [finetunedVertexModels.ft_filepicker_010_epoch_2]:
+    'ft_filepicker_010_epoch_2',
+  [finetunedVertexModels.ft_filepicker_topk_003]: 'ft_filepicker_topk_003',
+}
+export type FinetunedVertexModel =
+  (typeof finetunedVertexModels)[keyof typeof finetunedVertexModels]
+
+export const models = {
+  ...openaiModels,
+  ...deepseekModels,
+  ...mimoModels,
+  ...minimaxModels,
+  ...openrouterModels,
+  ...finetunedVertexModels,
+} as const
+
+export const shortModelNames = {
+  'gemini-2.5-pro': models.openrouter_gemini2_5_pro_preview,
+  'flash-2.5': models.openrouter_gemini2_5_flash,
+  'opus-4': models.openrouter_claude_opus_4,
+  'sonnet-4.5': models.openrouter_claude_sonnet_4_5,
+  'sonnet-4': models.openrouter_claude_sonnet_4,
+  'sonnet-3.7': models.openrouter_claude_sonnet_4,
+  'sonnet-3.6': models.openrouter_claude_3_5_sonnet,
+  'sonnet-3.5': models.openrouter_claude_3_5_sonnet,
+  'gpt-4.1': models.gpt4_1,
+  'o3-mini': models.o3mini,
+  o3: models.o3,
+  'o4-mini': models.o4mini,
+  'o3-pro': models.o3pro,
+}
+
+export const providerModelNames = {
+  ...Object.fromEntries(
+    Object.entries(openaiModels).map(([name, model]) => [
+      model,
+      'openai' as const,
+    ]),
+  ),
+  ...Object.fromEntries(
+    Object.entries(openrouterModels).map(([name, model]) => [
+      model,
+      'openrouter' as const,
+    ]),
+  ),
+}
+
+export type Model = (typeof models)[keyof typeof models] | (string & {})
+
+const explicitlyDefinedModels = new Set<string>(Object.values(models))
+
+/** Whether `model` is one of the statically configured model IDs. */
+export function isExplicitlyDefinedModel(model: Model): boolean {
+  return explicitlyDefinedModels.has(model)
+}
+
+const nonCacheableModels = [
+  models.openrouter_grok_4,
+] satisfies string[] as string[]
+export function supportsCacheControl(model: Model): boolean {
+  if (model.startsWith('openai/')) {
+    return true
+  }
+  if (model.startsWith('anthropic/')) {
+    return true
+  }
+  if (!isExplicitlyDefinedModel(model)) {
+    // Default to no cache control for unknown models
+    return false
+  }
+  return !nonCacheableModels.includes(model)
+}
+
+/**
+ * Claude 4.6+ (including Fable) rejects requests whose final message is an
+ * assistant message ("This model does not support assistant message prefill"),
+ * e.g. when routed through Amazon Bedrock. Older Claude models and other
+ * providers accept a trailing assistant message as a prefill to continue from.
+ */
+export function supportsAssistantPrefill(model: Model): boolean {
+  const match = model.match(/claude-(?:[a-z]+-)?(\d+(?:[.-]\d+)?)/)
+  if (!match) {
+    return true
+  }
+  const version = parseFloat(match[1].replace('-', '.'))
+  return version < 4.6
+}
+
+/**
+ * Token budget a model's conversation may reach before context-pruner
+ * summarizes it, compared against `agentState.contextTokenCount`.
+ *
+ * 400k by default: every model we serve has roughly a 1M window, which leaves
+ * ample headroom — including for the estimator being a GPT-4o count applied to
+ * models with their own tokenizers, so it can run under the provider's real
+ * number.
+ *
+ * The one exception is the 262,144-token Kimi K2.7 Code below, confirmed by a
+ * provider rejection quoted in anvil-models.ts. It gets 250k, the value it
+ * has been running on in prod. That margin is thin for exactly the estimator
+ * reason above, so it is the number to revisit if this model starts hitting
+ * context rejections. (The HY3 and Ling 3.0 Flash entries that used to sit
+ * alongside it went with those models on 2026-08-07. Kimi K3 Eco is NOT an
+ * exception: CrofAI serves it at a 1M context.)
+ *
+ * MiniMax M3 is deliberately NOT an exception: its real enforced limit is
+ * 524,288, not the 1,048,576 OpenRouter advertises (Fireworks rejects with
+ * "model maximum context length: 524287"), but 400k is still under it.
+ *
+ * The return type is the two budgets rather than `number` on purpose — base2
+ * pre-serializes one handleSteps variant per budget, so a third value has to be
+ * a compile error there rather than silently falling through to 400k.
+ */
+const SMALL_CONTEXT_MODELS: ReadonlySet<string> = new Set([
+  moonshotModels.kimiK27Code,
+])
+
+export function contextPrunerBudgetForModel(model: Model): 250_000 | 400_000 {
+  return SMALL_CONTEXT_MODELS.has(model) ? 250_000 : 400_000
+}
+
+export function getModelFromShortName(
+  modelName: string | undefined,
+): Model | undefined {
+  if (!modelName) return undefined
+  if (modelName && !(modelName in shortModelNames)) {
+    throw new Error(
+      `Unknown model: ${modelName}. Please use a valid model. Valid models are: ${Object.keys(
+        shortModelNames,
+      ).join(', ')}`,
+    )
+  }
+
+  return shortModelNames[modelName as keyof typeof shortModelNames]
+}
+
+export const providerDomains = {
+  google: 'google.com',
+  anthropic: 'anthropic.com',
+  openai: 'chatgpt.com',
+  deepseek: 'deepseek.com',
+  minimax: 'minimax.io',
+  mimo: 'xiaomi.com',
+  tencent: 'tencent.com',
+  xai: 'x.ai',
+} as const
+
+export function getLogoForModel(modelName: string): string | undefined {
+  let domain: string | undefined
+
+  if (Object.values(openaiModels).includes(modelName as OpenAIModel))
+    domain = providerDomains.openai
+  else if (Object.values(deepseekModels).includes(modelName as DeepseekModel))
+    domain = providerDomains.deepseek
+  else if (Object.values(minimaxModels).includes(modelName as MiniMaxModel))
+    domain = providerDomains.minimax
+  else if (Object.values(mimoModels).includes(modelName as MimoModel))
+    domain = providerDomains.mimo
+  else if (modelName.startsWith('tencent/')) domain = providerDomains.tencent
+  else if (modelName.includes('claude')) domain = providerDomains.anthropic
+  else if (modelName.includes('grok')) domain = providerDomains.xai
+
+  return domain
+    ? `https://www.google.com/s2/favicons?domain=${domain}&sz=256`
+    : undefined
+}

package/vendor/@anvil/common/src/constants/openrouter-attribution.ts

@@ -0,0 +1,8 @@
+// HTTP-Referer is required for OpenRouter to create the app attribution page.
+// Categories are capped at two per request (ten per app); unknown values are
+// silently ignored, so keep additions deliberate and spelling exact.
+export const OPENROUTER_DEFAULT_HEADERS = {
+  'HTTP-Referer': 'https://anvil.com',
+  'X-OpenRouter-Title': 'Anvil',
+  'X-OpenRouter-Categories': 'cli-agent,cloud-agent',
+} as const

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

@@ -0,0 +1,69 @@
+export const STOP_MARKER = '[' + 'END]'
+export const FIND_FILES_MARKER = '[' + 'FIND_FILES_PLEASE]'
+
+// Directory where agent template override files are stored
+export const AGENT_TEMPLATES_DIR = '.agents/'
+export const AGENT_DEFINITION_FILE = 'agent-definition.d.ts'
+
+export const API_KEY_ENV_VAR = 'ANVIL_API_KEY'
+
+export const INVALID_AUTH_TOKEN_MESSAGE =
+  'Invalid auth token. You may have been logged out from the web portal. Please log in again.'
+
+export const DEFAULT_IGNORED_PATHS = [
+  '.git',
+  '.env',
+  '.env.*',
+  '*.min.*',
+  'node_modules',
+  'venv',
+  'virtualenv',
+  '.venv',
+  '.virtualenv',
+  '__pycache__',
+  '*.egg-info/',
+  '*.pyc',
+  '.DS_Store',
+  '.pytest_cache',
+  '.mypy_cache',
+  '.ruff_cache',
+  '.next',
+  'package-lock.json',
+  'bun.lockb',
+]
+
+// Special message content tags indicating specific server states
+export const ASKED_CONFIG = 'asked_config'
+export const SHOULD_ASK_CONFIG = 'should_ask_config'
+export const ONE_TIME_TAGS = [] as const
+export const ONE_TIME_LABELS = [
+  ...ONE_TIME_TAGS,
+  ASKED_CONFIG,
+  SHOULD_ASK_CONFIG,
+] as const
+
+export const FILE_READ_STATUS = {
+  DOES_NOT_EXIST: '[FILE_DOES_NOT_EXIST]',
+  IGNORED: '[BLOCKED]',
+  TEMPLATE: '[TEMPLATE]',
+  OUTSIDE_PROJECT: '[FILE_OUTSIDE_PROJECT]',
+  TOO_LARGE: '[FILE_TOO_LARGE]',
+  ERROR: '[FILE_READ_ERROR]',
+} as const
+
+export const HIDDEN_FILE_READ_STATUS = [
+  FILE_READ_STATUS.DOES_NOT_EXIST,
+  FILE_READ_STATUS.IGNORED,
+  FILE_READ_STATUS.OUTSIDE_PROJECT,
+  FILE_READ_STATUS.TOO_LARGE,
+  FILE_READ_STATUS.ERROR,
+]
+
+export function toOptionalFile(file: string | null) {
+  if (file === null) return null
+  return HIDDEN_FILE_READ_STATUS.some((status) => file.startsWith(status))
+    ? null
+    : file
+}
+
+export const TEST_USER_ID = 'test-user-id'