@ggui-ai/ui-gen 0.8.0 → 0.10.0

package/dist/advanced/index.js

@@ -10,7 +10,10 @@ import path, { dirname, resolve, join, basename } from 'path';
 import { createRequire } from 'module';
 import { Linter } from 'eslint';
 import { createHash } from 'crypto';
+import 'fs/promises';
 import { tmpdir } from 'os';
+import { Readable } from 'stream';
+import { pipeline } from 'stream/promises';
 import { createBrotliDecompress, createUnzip } from 'zlib';
 import { fileURLToPath, pathToFileURL } from 'url';
 import { PlaywrightNotAvailableError, validateContractBehavior } from '@ggui-ai/ui-visual-tester';
@@ -1151,14 +1154,16 @@ var OpenRouterError;
 var init_types = __esm({
   "src/adapters/openrouter/types.ts"() {
     OpenRouterError = class extends Error {
-      constructor(message, status, code) {
+      constructor(message, status, code, headers) {
         super(message);
         this.status = status;
         this.code = code;
+        this.headers = headers;
         this.name = "OpenRouterError";
       }
       status;
       code;
+      headers;
       get isTransient() {
         return this.status === 408 || this.status === 429 || this.status === 502 || this.status === 503;
       }
@@ -1203,7 +1208,7 @@ var init_client2 = __esm({
         if (!response.ok) {
           const errorBody = await response.json().catch(() => ({ error: { message: response.statusText } }));
           const message = errorBody.error?.message ?? response.statusText;
-          throw new OpenRouterError(message, response.status);
+          throw new OpenRouterError(message, response.status, void 0, response.headers);
         }
         return response.json();
       }
@@ -1221,7 +1226,7 @@ var init_client2 = __esm({
         if (!response.ok) {
           const errorBody = await response.json().catch(() => ({ error: { message: response.statusText } }));
           const message = errorBody.error?.message ?? response.statusText;
-          throw new OpenRouterError(message, response.status);
+          throw new OpenRouterError(message, response.status, void 0, response.headers);
         }
         if (!response.body) {
           throw new OpenRouterError("No response body for streaming request", 500);
@@ -1888,8 +1893,8 @@ var init_ui_compiler = __esm({
       "@ggui-ai/design/*",
       "@ggui-ai/wire",
       "@ggui-ai/wire/*",
-      "@ggui-ai/react",
-      "@ggui-ai/react/*"
+      "@ggui-ai/mcp-apps-react",
+      "@ggui-ai/mcp-apps-react/*"
     ];
     MAX_BUNDLE_SIZE = 2 * 1024 * 1024;
     UiValidationError = class extends Error {
@@ -2074,6 +2079,15 @@ function jsonSchemaTypeToTs(schema) {
   if (schema.enum?.length) {
     return schema.enum.map((v) => typeof v === "string" ? `'${v}'` : String(v)).join(" | ");
   }
+  if (Array.isArray(schema.type)) {
+    const { nullable: _nullable, ...rest } = schema;
+    const members = [...new Set(schema.type)].map(
+      (member) => jsonSchemaTypeToTs({ ...rest, type: member })
+    );
+    const unique = [...new Set(members)];
+    if (schema.nullable && !unique.includes("null")) unique.push("null");
+    return unique.join(" | ");
+  }
   let result;
   switch (schema.type) {
     case "string":
@@ -2091,7 +2105,8 @@ function jsonSchemaTypeToTs(schema) {
     case "array": {
       if (schema.items) {
         const itemType = jsonSchemaTypeToTs(schema.items);
-        result = schema.items.type === "object" && schema.items.properties ? `Array<${itemType}>` : itemType.includes("|") ? `(${itemType})[]` : `${itemType}[]`;
+        const itemsDeclareObject = Array.isArray(schema.items.type) ? schema.items.type.includes("object") : schema.items.type === "object";
+        result = itemsDeclareObject && schema.items.properties ? `Array<${itemType}>` : itemType.includes("|") ? `(${itemType})[]` : `${itemType}[]`;
       } else {
         result = "unknown[]";
       }
@@ -4109,6 +4124,29 @@ function errorSummary(e) {
   }
   return `${e.constructor.name}${status}${code}: ${e.message.slice(0, 120)}${body}`;
 }
+function isRateLimited(e) {
+  if (!(e instanceof Error) || !("status" in e)) return false;
+  return e.status === 429;
+}
+function extractStatus(e) {
+  if (!(e instanceof Error) || !("status" in e)) return void 0;
+  const status = e.status;
+  return typeof status === "number" ? status : void 0;
+}
+function extractRetryAfterSec(e) {
+  if (!(e instanceof Error) || !("headers" in e)) return void 0;
+  const headers = e.headers;
+  if (headers === null || typeof headers !== "object" || !("get" in headers) || typeof headers.get !== "function") {
+    return void 0;
+  }
+  const raw = headers.get("retry-after");
+  if (raw === null) return void 0;
+  const parsed = Number(raw);
+  return Number.isFinite(parsed) && parsed >= 0 ? Math.floor(parsed) : void 0;
+}
+function sleep(ms) {
+  return new Promise((resolve3) => setTimeout(resolve3, ms));
+}
 function interactionText(interaction) {
   let text = "";
   for (const step of interaction.steps ?? []) {
@@ -4130,25 +4168,41 @@ function functionCallSteps(interaction) {
 function toUserInputStep(text) {
   return { type: "user_input", content: [{ type: "text", text }] };
 }
-function createAgent(provider) {
+function createAgent(providerOrConfig) {
+  const provider = typeof providerOrConfig === "string" ? providerOrConfig : providerOrConfig.provider;
+  const routeOverride = typeof providerOrConfig === "string" ? void 0 : providerOrConfig.routeOverride;
+  const onRetry = typeof providerOrConfig === "string" ? void 0 : providerOrConfig.onRetry;
   switch (provider) {
     case "anthropic":
-      return new AnthropicAgent();
+      return new AnthropicAgent(routeOverride, onRetry);
     case "openai":
-      return new OpenAIAgent();
+      return new OpenAIAgent(routeOverride, onRetry);
     case "google":
-      return new GoogleAgent();
+      return new GoogleAgent(routeOverride, onRetry);
     case "openrouter":
-      return new OpenRouterAgent();
+      return new OpenRouterAgent(routeOverride, onRetry);
+  }
+}
+function createVisionAgent(config) {
+  switch (config.provider) {
+    case "anthropic":
+      return new AnthropicAgent(config.routeOverride, config.onRetry);
+    case "google":
+      return new GoogleAgent(config.routeOverride, config.onRetry);
   }
 }
-var LLMAgent, AnthropicAgent, OpenAIAgent, GoogleAgent, OpenRouterAgent;
+var MAX_RETRY_ATTEMPTS, RETRY_AFTER_CAP_SEC, DEFAULT_BACKOFF_BASE_MS, DEFAULT_BACKOFF_MAX_MS, MAX_TOTAL_RETRY_DELAY_MS, LLMAgent, AnthropicAgent, OpenAIAgent, GoogleAgent, OpenRouterAgent;
 var init_llm_router = __esm({
   "src/harness/llm-router.ts"() {
     init_client();
     init_provider_router();
     init_tool_bridge();
     init_llm_trace_sink();
+    MAX_RETRY_ATTEMPTS = 2;
+    RETRY_AFTER_CAP_SEC = 15;
+    DEFAULT_BACKOFF_BASE_MS = 1e3;
+    DEFAULT_BACKOFF_MAX_MS = 8e3;
+    MAX_TOTAL_RETRY_DELAY_MS = 2e4;
     LLMAgent = class {
       client = null;
       // ── Session state for server-side chaining ──────────────
@@ -4156,6 +4210,19 @@ var init_llm_router = __esm({
       // Enables turn 2+ to skip re-sending system prompt + history.
       // Call resetSession() between independent generation runs.
       lastSessionId;
+      /**
+       * Explicit per-call routing override — see `AgentConfig.routeOverride`.
+       * Absent when constructed via the bare `new XAgent()` form (every
+       * existing call site), so `createClient()`/`resolveModel()` fall
+       * back to `process.env` exactly as before.
+       */
+      routeOverride;
+      /** See `AgentConfig.onRetry` (#489). Absent is a no-op. */
+      onRetry;
+      constructor(routeOverride, onRetry) {
+        this.routeOverride = routeOverride;
+        this.onRetry = onRetry;
+      }
       async getClient() {
         if (!this.client) {
           this.client = await this.createClient();
@@ -4189,36 +4256,104 @@ var init_llm_router = __esm({
       async sendToolResult(_results) {
       }
       /**
-       * Execute an API call. No retry — if it fails, it fails.
-       * Logs the error with provider context and re-throws.
+       * Execute an API call, retrying once or twice on HTTP 429
+       * (rate-limited) before giving up (#489).
+       *
+       * Policy: on a 429, honor the provider's `Retry-After` header when
+       * present (capped at `RETRY_AFTER_CAP_SEC` — a provider asking for a
+       * longer wait is treated as "don't retry", not "wait longer": making
+       * the caller sit through 15+ more seconds on a single failed call is
+       * a bad experience regardless of what's driving the request);
+       * otherwise fall back to exponential backoff with jitter, capped at
+       * `DEFAULT_BACKOFF_MAX_MS` per attempt. Stops after
+       * `MAX_RETRY_ATTEMPTS` retries OR once the cumulative delay would
+       * exceed `MAX_TOTAL_RETRY_DELAY_MS`, whichever comes first. Any
+       * non-429 error, or a 429 with no attempts left, is logged and
+       * re-thrown immediately — unchanged from the pre-#489 behavior.
+       *
+       * **Budget scope (final-review correction):** `MAX_TOTAL_RETRY_DELAY_MS`
+       * bounds a single `apiCall()` invocation, not a whole generation. A
+       * generation issues many sequential `apiCall()` calls (coding turns,
+       * tool-result round-trips, eval rounds); under sustained throttling
+       * each one can independently add up to `MAX_TOTAL_RETRY_DELAY_MS`, so
+       * a generation with k rate-limited calls can add up to roughly `k *
+       * MAX_TOTAL_RETRY_DELAY_MS` to how long it holds its caller's
+       * resources (e.g. the caller's concurrency slot) — not a flat 20s
+       * ceiling. No shared per-generation budget is threaded here by
+       * design (accepted ruling, not an oversight): the caller's own
+       * queue/admission backstop is what bounds how long other
+       * queued work waits, independent of any one generation's retry
+       * total.
        */
       async apiCall(fn) {
         const start = Date.now();
-        try {
-          return await fn();
-        } catch (e) {
-          const ms = Date.now() - start;
-          console.error(`[${this.provider}] API error after ${ms}ms: ${errorSummary(e)}`);
-          throw e;
+        let totalDelayMs = 0;
+        for (let attempt = 0; ; attempt++) {
+          try {
+            return await fn();
+          } catch (e) {
+            const ms = Date.now() - start;
+            if (attempt >= MAX_RETRY_ATTEMPTS || !isRateLimited(e)) {
+              console.error(`[${this.provider}] API error after ${ms}ms: ${errorSummary(e)}`);
+              throw e;
+            }
+            const retryAfterSec = extractRetryAfterSec(e);
+            if (retryAfterSec !== void 0 && retryAfterSec > RETRY_AFTER_CAP_SEC) {
+              console.error(
+                `[${this.provider}] API error after ${ms}ms (retry-after ${retryAfterSec}s exceeds ${RETRY_AFTER_CAP_SEC}s cap, not retrying): ${errorSummary(e)}`
+              );
+              throw e;
+            }
+            const delayMs = retryAfterSec !== void 0 ? retryAfterSec * 1e3 : Math.min(DEFAULT_BACKOFF_BASE_MS * 2 ** attempt, DEFAULT_BACKOFF_MAX_MS) + Math.floor(Math.random() * 250);
+            if (totalDelayMs + delayMs > MAX_TOTAL_RETRY_DELAY_MS) {
+              console.error(
+                `[${this.provider}] API error after ${ms}ms (retry budget exhausted, not retrying): ${errorSummary(e)}`
+              );
+              throw e;
+            }
+            totalDelayMs += delayMs;
+            const info = {
+              provider: this.provider,
+              attempt: attempt + 1,
+              maxAttempts: MAX_RETRY_ATTEMPTS,
+              status: extractStatus(e),
+              retryAfterSec,
+              delayMs,
+              message: errorSummary(e)
+            };
+            console.warn(
+              `[${this.provider}] rate-limited (attempt ${info.attempt}/${info.maxAttempts}), retrying in ${delayMs}ms`
+            );
+            try {
+              this.onRetry?.(info);
+            } catch (observerError) {
+              console.warn(
+                `[${this.provider}] onRetry observer threw (ignored, retry proceeds): ${errorSummary(observerError)}`
+              );
+            }
+            await sleep(delayMs);
+          }
         }
       }
     };
     AnthropicAgent = class extends LLMAgent {
       provider = "anthropic";
       resolveModel(model) {
-        if (process.env.CLAUDE_CODE_USE_BEDROCK === "1") {
+        const useBedrock = this.routeOverride?.useBedrock ?? process.env.CLAUDE_CODE_USE_BEDROCK === "1";
+        if (useBedrock) {
           return getBedrockModelId(model);
         }
         return model.startsWith("anthropic/") ? model.slice("anthropic/".length) : model;
       }
       async createClient() {
-        if (process.env.CLAUDE_CODE_USE_BEDROCK === "1") {
+        const useBedrock = this.routeOverride?.useBedrock ?? process.env.CLAUDE_CODE_USE_BEDROCK === "1";
+        if (useBedrock) {
           const { AnthropicBedrock } = await import('@anthropic-ai/bedrock-sdk');
           return new AnthropicBedrock({
             awsRegion: process.env.AWS_REGION ?? process.env.AWS_DEFAULT_REGION ?? "us-east-1"
           });
         }
-        return createAnthropicClient(process.env.ANTHROPIC_API_KEY);
+        return createAnthropicClient(this.routeOverride?.apiKey ?? process.env.ANTHROPIC_API_KEY);
       }
       async callText(model, systemPrompt, userPrompt, maxTokens, temperature) {
         const client = await this.getClient();
@@ -4290,6 +4425,73 @@ var init_llm_router = __esm({
           throw e;
         }
       }
+      async callVision(model, systemPrompt, userPrompt, image, maxTokens) {
+        const client = await this.getClient();
+        const traceId = newLlmTraceId();
+        const startedAt = Date.now();
+        const resolvedModel = this.resolveModel(model);
+        const imageBlock = {
+          type: "image",
+          source: {
+            type: "base64",
+            media_type: image.mediaType,
+            data: image.base64
+          }
+        };
+        try {
+          const response = await this.apiCall(
+            () => client.messages.create({
+              model: resolvedModel,
+              max_tokens: maxTokens ?? 1500,
+              system: systemPrompt,
+              messages: [
+                {
+                  role: "user",
+                  content: [imageBlock, { type: "text", text: userPrompt }]
+                }
+              ]
+            })
+          );
+          const text = response.content.filter((block) => block.type === "text").map((block) => block.text).join("");
+          const endedAt = Date.now();
+          emitLlmTraceEvent({
+            id: traceId,
+            at: startedAt,
+            endedAt,
+            durationMs: endedAt - startedAt,
+            provider: "anthropic",
+            model: resolvedModel,
+            kind: "callVision",
+            systemPrompt,
+            userPrompt,
+            result: {
+              inputTokens: response.usage.input_tokens,
+              outputTokens: response.usage.output_tokens,
+              text
+            }
+          });
+          return {
+            text,
+            inputTokens: response.usage.input_tokens,
+            outputTokens: response.usage.output_tokens
+          };
+        } catch (e) {
+          const endedAt = Date.now();
+          emitLlmTraceEvent({
+            id: traceId,
+            at: startedAt,
+            endedAt,
+            durationMs: endedAt - startedAt,
+            provider: "anthropic",
+            model: resolvedModel,
+            kind: "callVision",
+            systemPrompt,
+            userPrompt,
+            error: { message: e instanceof Error ? e.message : String(e) }
+          });
+          throw e;
+        }
+      }
       async callTools(model, systemPrompt, userPrompt, tools, toolChoice = "required", _scopedTools) {
         const client = await this.getClient();
         const traceId = newLlmTraceId();
@@ -4489,7 +4691,7 @@ var init_llm_router = __esm({
       }
       async createClient() {
         const { default: OpenAISDK } = await import('openai');
-        return new OpenAISDK({ apiKey: process.env.OPENAI_API_KEY });
+        return new OpenAISDK({ apiKey: this.routeOverride?.apiKey ?? process.env.OPENAI_API_KEY });
       }
       async callText(model, systemPrompt, userPrompt, maxTokens, temperature) {
         const client = await this.getClient();
@@ -4639,7 +4841,7 @@ var init_llm_router = __esm({
       async createClient() {
         const { GoogleGenAI: GoogleGenAISDK } = await import('@google/genai');
         return new GoogleGenAISDK({
-          apiKey: process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY,
+          apiKey: this.routeOverride?.apiKey ?? (process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY),
           httpOptions: { timeout: 3e5 }
           // 5 min — Pro models can be slow
         });
@@ -4664,6 +4866,72 @@ var init_llm_router = __esm({
           outputTokens: interaction.usage?.total_output_tokens ?? 0
         };
       }
+      async callVision(model, systemPrompt, userPrompt, image, maxTokens) {
+        const client = await this.getClient();
+        const traceId = newLlmTraceId();
+        const startedAt = Date.now();
+        const resolvedModel = this.resolveModel(model);
+        try {
+          const response = await this.apiCall(
+            () => client.models.generateContent({
+              model: resolvedModel,
+              contents: [
+                {
+                  role: "user",
+                  parts: [
+                    { inlineData: { mimeType: image.mediaType, data: image.base64 } },
+                    { text: userPrompt }
+                  ]
+                }
+              ],
+              config: {
+                systemInstruction: systemPrompt,
+                ...maxTokens ? { maxOutputTokens: maxTokens } : {}
+              }
+            })
+          );
+          const text = response.candidates?.[0]?.content?.parts?.map((p) => p.text || "").join("") || "";
+          const usage = response.usageMetadata;
+          const result = {
+            text,
+            inputTokens: usage?.promptTokenCount ?? 0,
+            outputTokens: usage?.candidatesTokenCount ?? 0
+          };
+          const endedAt = Date.now();
+          emitLlmTraceEvent({
+            id: traceId,
+            at: startedAt,
+            endedAt,
+            durationMs: endedAt - startedAt,
+            provider: "google",
+            model: resolvedModel,
+            kind: "callVision",
+            systemPrompt,
+            userPrompt,
+            result: {
+              inputTokens: result.inputTokens,
+              outputTokens: result.outputTokens,
+              text
+            }
+          });
+          return result;
+        } catch (e) {
+          const endedAt = Date.now();
+          emitLlmTraceEvent({
+            id: traceId,
+            at: startedAt,
+            endedAt,
+            durationMs: endedAt - startedAt,
+            provider: "google",
+            model: resolvedModel,
+            kind: "callVision",
+            systemPrompt,
+            userPrompt,
+            error: { message: e instanceof Error ? e.message : String(e) }
+          });
+          throw e;
+        }
+      }
       async callTools(model, systemPrompt, userPrompt, tools, _toolChoice = "required", scopedTools) {
         const client = await this.getClient();
         const interactionTools = tools.map((t) => ({
@@ -4866,7 +5134,7 @@ var init_llm_router = __esm({
       async createClient() {
         const { OpenRouterClient: OpenRouterClient2 } = await Promise.resolve().then(() => (init_client2(), client_exports));
         return new OpenRouterClient2({
-          apiKey: process.env.OPENROUTER_API_KEY
+          apiKey: this.routeOverride?.apiKey ?? process.env.OPENROUTER_API_KEY
         });
       }
       async callText(model, systemPrompt, userPrompt, maxTokens, temperature) {
@@ -6008,7 +6276,11 @@ async function runLLMEvaluation(context, config, preWarmedContext) {
     designSystemSummary: context.designContext
   });
   const numberedSource = context.sourceCode.split("\n").map((line, i) => `${String(i + 1).padStart(4)} | ${line}`).join("\n");
-  const agent = createAgent(routerProvider);
+  const agent = createAgent({
+    provider: routerProvider,
+    routeOverride: config.routeOverride,
+    onRetry: config.onRetry
+  });
   const evalStart = Date.now();
   const totalCriteriaCount = TIER_1_CRITERIA.length + TIER_2_CRITERIA.length;
   const results = await Promise.all([
@@ -6018,1399 +6290,107 @@ async function runLLMEvaluation(context, config, preWarmedContext) {
   const allIssues = [];
   const passCategories = [];
   let totalIn = 0;
-  let totalOut = 0;
-  let cachedTokensEstimate = 0;
-  for (const r of results) {
-    allIssues.push(...r.issues);
-    if (r.pass) {
-      passCategories.push(r.criterion);
-    }
-    totalIn += r.tokens.in;
-    totalOut += r.tokens.out;
-  }
-  const firstResult = results[0];
-  if (firstResult && firstResult.tokens.in > 0) {
-    cachedTokensEstimate = firstResult.tokens.in * (totalCriteriaCount - 1);
-  }
-  const wallMs = Date.now() - evalStart;
-  for (const r of results) {
-    const issueCount = r.issues.length;
-    const status = r.pass ? "PASS" : r.tier === 1 ? "FAIL" : r.issues.some((i) => i.result === "fail") ? "FAIL" : "WARN";
-    const issueLabel = issueCount > 0 ? ` (${issueCount} issue${issueCount > 1 ? "s" : ""})` : "";
-    console.log(`[eval] ${r.criterion}: ${status}${issueLabel} ${(r.durationMs / 1e3).toFixed(1)}s`);
-  }
-  console.log(
-    `[eval] total: ${(wallMs / 1e3).toFixed(1)}s wall (${totalCriteriaCount} parallel) | in=${totalIn} out=${totalOut} cached~=${cachedTokensEstimate} | issues=${allIssues.length} pass=${passCategories.length}`
-  );
-  return {
-    issues: allIssues,
-    pass: passCategories,
-    inputTokens: totalIn,
-    outputTokens: totalOut
-  };
-}
-var TIER_1_CRITERIA, TIER_2_CRITERIA, TIER_1_CATEGORIES, TIER_2_CATEGORIES, VALID_CATEGORIES;
-var init_llm_evaluator = __esm({
-  "src/evaluation/llm-evaluator.ts"() {
-    init_llm_router();
-    init_types_public();
-    TIER_1_CRITERIA = ["functionality", "crash"];
-    TIER_2_CRITERIA = ["interactivity", "accessibility", "layout", "loading", "visual"];
-    TIER_1_CATEGORIES = /* @__PURE__ */ new Set(["functionality", "crash"]);
-    TIER_2_CATEGORIES = /* @__PURE__ */ new Set([
-      "interactivity",
-      "accessibility",
-      "layout",
-      "loading",
-      "visual"
-    ]);
-    VALID_CATEGORIES = /* @__PURE__ */ new Set([
-      ...TIER_1_CATEGORIES,
-      ...TIER_2_CATEGORIES
-    ]);
-  }
-});
-
-// src/evaluation/cost-tracker.ts
-var cost_tracker_exports = {};
-__export(cost_tracker_exports, {
-  CostTracker: () => CostTracker,
-  pricePer1k: () => pricePer1k
-});
-function resolveRegistryId(model) {
-  const keys = Object.keys(MODEL_REGISTRY);
-  if (keys.includes(model)) return model;
-  const bySuffix = keys.find((id) => id.endsWith(`/${model}`));
-  if (bySuffix) return bySuffix;
-  const undated = model.replace(/-\d{8}$/, "");
-  return keys.find((id) => id.endsWith(`/${undated}`)) ?? null;
-}
-function pricePer1k(model) {
-  const id = resolveRegistryId(model);
-  if (id === null) return FALLBACK_PER_1K;
-  const { costs } = MODEL_REGISTRY[id];
-  return { input: costs.inputPer1M / 1e3, output: costs.outputPer1M / 1e3 };
-}
-var FALLBACK_PER_1K, CostTracker;
-var init_cost_tracker = __esm({
-  "src/evaluation/cost-tracker.ts"() {
-    FALLBACK_PER_1K = { input: 3e-3, output: 0.015 };
-    CostTracker = class {
-      constructor(maxBudget) {
-        this.maxBudget = maxBudget;
-      }
-      maxBudget;
-      totalCost = 0;
-      record(model, inputTokens, outputTokens) {
-        const prices = pricePer1k(model);
-        const cost = inputTokens / 1e3 * prices.input + outputTokens / 1e3 * prices.output;
-        this.totalCost += cost;
-        return cost;
-      }
-      canContinue() {
-        if (this.maxBudget === null) return true;
-        return this.totalCost < this.maxBudget;
-      }
-      getTotal() {
-        return this.totalCost;
-      }
-      getRemaining() {
-        if (this.maxBudget === null) return null;
-        return Math.max(0, this.maxBudget - this.totalCost);
-      }
-    };
-  }
-});
-
-// ../../node_modules/ms/index.js
-var require_ms = __commonJS({
-  "../../node_modules/ms/index.js"(exports, module) {
-    var s = 1e3;
-    var m = s * 60;
-    var h = m * 60;
-    var d = h * 24;
-    var w = d * 7;
-    var y = d * 365.25;
-    module.exports = function(val, options) {
-      options = options || {};
-      var type = typeof val;
-      if (type === "string" && val.length > 0) {
-        return parse(val);
-      } else if (type === "number" && isFinite(val)) {
-        return options.long ? fmtLong(val) : fmtShort(val);
-      }
-      throw new Error(
-        "val is not a non-empty string or a valid number. val=" + JSON.stringify(val)
-      );
-    };
-    function parse(str) {
-      str = String(str);
-      if (str.length > 100) {
-        return;
-      }
-      var match = /^(-?(?:\d+)?\.?\d+) *(milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|years?|yrs?|y)?$/i.exec(
-        str
-      );
-      if (!match) {
-        return;
-      }
-      var n = parseFloat(match[1]);
-      var type = (match[2] || "ms").toLowerCase();
-      switch (type) {
-        case "years":
-        case "year":
-        case "yrs":
-        case "yr":
-        case "y":
-          return n * y;
-        case "weeks":
-        case "week":
-        case "w":
-          return n * w;
-        case "days":
-        case "day":
-        case "d":
-          return n * d;
-        case "hours":
-        case "hour":
-        case "hrs":
-        case "hr":
-        case "h":
-          return n * h;
-        case "minutes":
-        case "minute":
-        case "mins":
-        case "min":
-        case "m":
-          return n * m;
-        case "seconds":
-        case "second":
-        case "secs":
-        case "sec":
-        case "s":
-          return n * s;
-        case "milliseconds":
-        case "millisecond":
-        case "msecs":
-        case "msec":
-        case "ms":
-          return n;
-        default:
-          return void 0;
-      }
-    }
-    function fmtShort(ms) {
-      var msAbs = Math.abs(ms);
-      if (msAbs >= d) {
-        return Math.round(ms / d) + "d";
-      }
-      if (msAbs >= h) {
-        return Math.round(ms / h) + "h";
-      }
-      if (msAbs >= m) {
-        return Math.round(ms / m) + "m";
-      }
-      if (msAbs >= s) {
-        return Math.round(ms / s) + "s";
-      }
-      return ms + "ms";
-    }
-    function fmtLong(ms) {
-      var msAbs = Math.abs(ms);
-      if (msAbs >= d) {
-        return plural(ms, msAbs, d, "day");
-      }
-      if (msAbs >= h) {
-        return plural(ms, msAbs, h, "hour");
-      }
-      if (msAbs >= m) {
-        return plural(ms, msAbs, m, "minute");
-      }
-      if (msAbs >= s) {
-        return plural(ms, msAbs, s, "second");
-      }
-      return ms + " ms";
-    }
-    function plural(ms, msAbs, n, name) {
-      var isPlural = msAbs >= n * 1.5;
-      return Math.round(ms / n) + " " + name + (isPlural ? "s" : "");
-    }
-  }
-});
-
-// ../../node_modules/debug/src/common.js
-var require_common = __commonJS({
-  "../../node_modules/debug/src/common.js"(exports, module) {
-    function setup(env) {
-      createDebug.debug = createDebug;
-      createDebug.default = createDebug;
-      createDebug.coerce = coerce;
-      createDebug.disable = disable;
-      createDebug.enable = enable;
-      createDebug.enabled = enabled;
-      createDebug.humanize = require_ms();
-      createDebug.destroy = destroy;
-      Object.keys(env).forEach((key) => {
-        createDebug[key] = env[key];
-      });
-      createDebug.names = [];
-      createDebug.skips = [];
-      createDebug.formatters = {};
-      function selectColor(namespace) {
-        let hash = 0;
-        for (let i = 0; i < namespace.length; i++) {
-          hash = (hash << 5) - hash + namespace.charCodeAt(i);
-          hash |= 0;
-        }
-        return createDebug.colors[Math.abs(hash) % createDebug.colors.length];
-      }
-      createDebug.selectColor = selectColor;
-      function createDebug(namespace) {
-        let prevTime;
-        let enableOverride = null;
-        let namespacesCache;
-        let enabledCache;
-        function debug(...args) {
-          if (!debug.enabled) {
-            return;
-          }
-          const self = debug;
-          const curr = Number(/* @__PURE__ */ new Date());
-          const ms = curr - (prevTime || curr);
-          self.diff = ms;
-          self.prev = prevTime;
-          self.curr = curr;
-          prevTime = curr;
-          args[0] = createDebug.coerce(args[0]);
-          if (typeof args[0] !== "string") {
-            args.unshift("%O");
-          }
-          let index = 0;
-          args[0] = args[0].replace(/%([a-zA-Z%])/g, (match, format) => {
-            if (match === "%%") {
-              return "%";
-            }
-            index++;
-            const formatter = createDebug.formatters[format];
-            if (typeof formatter === "function") {
-              const val = args[index];
-              match = formatter.call(self, val);
-              args.splice(index, 1);
-              index--;
-            }
-            return match;
-          });
-          createDebug.formatArgs.call(self, args);
-          const logFn = self.log || createDebug.log;
-          logFn.apply(self, args);
-        }
-        debug.namespace = namespace;
-        debug.useColors = createDebug.useColors();
-        debug.color = createDebug.selectColor(namespace);
-        debug.extend = extend;
-        debug.destroy = createDebug.destroy;
-        Object.defineProperty(debug, "enabled", {
-          enumerable: true,
-          configurable: false,
-          get: () => {
-            if (enableOverride !== null) {
-              return enableOverride;
-            }
-            if (namespacesCache !== createDebug.namespaces) {
-              namespacesCache = createDebug.namespaces;
-              enabledCache = createDebug.enabled(namespace);
-            }
-            return enabledCache;
-          },
-          set: (v) => {
-            enableOverride = v;
-          }
-        });
-        if (typeof createDebug.init === "function") {
-          createDebug.init(debug);
-        }
-        return debug;
-      }
-      function extend(namespace, delimiter) {
-        const newDebug = createDebug(this.namespace + (typeof delimiter === "undefined" ? ":" : delimiter) + namespace);
-        newDebug.log = this.log;
-        return newDebug;
-      }
-      function enable(namespaces) {
-        createDebug.save(namespaces);
-        createDebug.namespaces = namespaces;
-        createDebug.names = [];
-        createDebug.skips = [];
-        const split = (typeof namespaces === "string" ? namespaces : "").trim().replace(/\s+/g, ",").split(",").filter(Boolean);
-        for (const ns of split) {
-          if (ns[0] === "-") {
-            createDebug.skips.push(ns.slice(1));
-          } else {
-            createDebug.names.push(ns);
-          }
-        }
-      }
-      function matchesTemplate(search, template) {
-        let searchIndex = 0;
-        let templateIndex = 0;
-        let starIndex = -1;
-        let matchIndex = 0;
-        while (searchIndex < search.length) {
-          if (templateIndex < template.length && (template[templateIndex] === search[searchIndex] || template[templateIndex] === "*")) {
-            if (template[templateIndex] === "*") {
-              starIndex = templateIndex;
-              matchIndex = searchIndex;
-              templateIndex++;
-            } else {
-              searchIndex++;
-              templateIndex++;
-            }
-          } else if (starIndex !== -1) {
-            templateIndex = starIndex + 1;
-            matchIndex++;
-            searchIndex = matchIndex;
-          } else {
-            return false;
-          }
-        }
-        while (templateIndex < template.length && template[templateIndex] === "*") {
-          templateIndex++;
-        }
-        return templateIndex === template.length;
-      }
-      function disable() {
-        const namespaces = [
-          ...createDebug.names,
-          ...createDebug.skips.map((namespace) => "-" + namespace)
-        ].join(",");
-        createDebug.enable("");
-        return namespaces;
-      }
-      function enabled(name) {
-        for (const skip of createDebug.skips) {
-          if (matchesTemplate(name, skip)) {
-            return false;
-          }
-        }
-        for (const ns of createDebug.names) {
-          if (matchesTemplate(name, ns)) {
-            return true;
-          }
-        }
-        return false;
-      }
-      function coerce(val) {
-        if (val instanceof Error) {
-          return val.stack || val.message;
-        }
-        return val;
-      }
-      function destroy() {
-        console.warn("Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.");
-      }
-      createDebug.enable(createDebug.load());
-      return createDebug;
-    }
-    module.exports = setup;
-  }
-});
-
-// ../../node_modules/debug/src/browser.js
-var require_browser = __commonJS({
-  "../../node_modules/debug/src/browser.js"(exports, module) {
-    exports.formatArgs = formatArgs;
-    exports.save = save;
-    exports.load = load;
-    exports.useColors = useColors;
-    exports.storage = localstorage();
-    exports.destroy = /* @__PURE__ */ (() => {
-      let warned = false;
-      return () => {
-        if (!warned) {
-          warned = true;
-          console.warn("Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.");
-        }
-      };
-    })();
-    exports.colors = [
-      "#0000CC",
-      "#0000FF",
-      "#0033CC",
-      "#0033FF",
-      "#0066CC",
-      "#0066FF",
-      "#0099CC",
-      "#0099FF",
-      "#00CC00",
-      "#00CC33",
-      "#00CC66",
-      "#00CC99",
-      "#00CCCC",
-      "#00CCFF",
-      "#3300CC",
-      "#3300FF",
-      "#3333CC",
-      "#3333FF",
-      "#3366CC",
-      "#3366FF",
-      "#3399CC",
-      "#3399FF",
-      "#33CC00",
-      "#33CC33",
-      "#33CC66",
-      "#33CC99",
-      "#33CCCC",
-      "#33CCFF",
-      "#6600CC",
-      "#6600FF",
-      "#6633CC",
-      "#6633FF",
-      "#66CC00",
-      "#66CC33",
-      "#9900CC",
-      "#9900FF",
-      "#9933CC",
-      "#9933FF",
-      "#99CC00",
-      "#99CC33",
-      "#CC0000",
-      "#CC0033",
-      "#CC0066",
-      "#CC0099",
-      "#CC00CC",
-      "#CC00FF",
-      "#CC3300",
-      "#CC3333",
-      "#CC3366",
-      "#CC3399",
-      "#CC33CC",
-      "#CC33FF",
-      "#CC6600",
-      "#CC6633",
-      "#CC9900",
-      "#CC9933",
-      "#CCCC00",
-      "#CCCC33",
-      "#FF0000",
-      "#FF0033",
-      "#FF0066",
-      "#FF0099",
-      "#FF00CC",
-      "#FF00FF",
-      "#FF3300",
-      "#FF3333",
-      "#FF3366",
-      "#FF3399",
-      "#FF33CC",
-      "#FF33FF",
-      "#FF6600",
-      "#FF6633",
-      "#FF9900",
-      "#FF9933",
-      "#FFCC00",
-      "#FFCC33"
-    ];
-    function useColors() {
-      if (typeof window !== "undefined" && window.process && (window.process.type === "renderer" || window.process.__nwjs)) {
-        return true;
-      }
-      if (typeof navigator !== "undefined" && navigator.userAgent && navigator.userAgent.toLowerCase().match(/(edge|trident)\/(\d+)/)) {
-        return false;
-      }
-      let m;
-      return typeof document !== "undefined" && document.documentElement && document.documentElement.style && document.documentElement.style.WebkitAppearance || // Is firebug? http://stackoverflow.com/a/398120/376773
-      typeof window !== "undefined" && window.console && (window.console.firebug || window.console.exception && window.console.table) || // Is firefox >= v31?
-      // https://developer.mozilla.org/en-US/docs/Tools/Web_Console#Styling_messages
-      typeof navigator !== "undefined" && navigator.userAgent && (m = navigator.userAgent.toLowerCase().match(/firefox\/(\d+)/)) && parseInt(m[1], 10) >= 31 || // Double check webkit in userAgent just in case we are in a worker
-      typeof navigator !== "undefined" && navigator.userAgent && navigator.userAgent.toLowerCase().match(/applewebkit\/(\d+)/);
-    }
-    function formatArgs(args) {
-      args[0] = (this.useColors ? "%c" : "") + this.namespace + (this.useColors ? " %c" : " ") + args[0] + (this.useColors ? "%c " : " ") + "+" + module.exports.humanize(this.diff);
-      if (!this.useColors) {
-        return;
-      }
-      const c = "color: " + this.color;
-      args.splice(1, 0, c, "color: inherit");
-      let index = 0;
-      let lastC = 0;
-      args[0].replace(/%[a-zA-Z%]/g, (match) => {
-        if (match === "%%") {
-          return;
-        }
-        index++;
-        if (match === "%c") {
-          lastC = index;
-        }
-      });
-      args.splice(lastC, 0, c);
-    }
-    exports.log = console.debug || console.log || (() => {
-    });
-    function save(namespaces) {
-      try {
-        if (namespaces) {
-          exports.storage.setItem("debug", namespaces);
-        } else {
-          exports.storage.removeItem("debug");
-        }
-      } catch (error) {
-      }
-    }
-    function load() {
-      let r;
-      try {
-        r = exports.storage.getItem("debug") || exports.storage.getItem("DEBUG");
-      } catch (error) {
-      }
-      if (!r && typeof process !== "undefined" && "env" in process) {
-        r = process.env.DEBUG;
-      }
-      return r;
-    }
-    function localstorage() {
-      try {
-        return localStorage;
-      } catch (error) {
-      }
-    }
-    module.exports = require_common()(exports);
-    var { formatters } = module.exports;
-    formatters.j = function(v) {
-      try {
-        return JSON.stringify(v);
-      } catch (error) {
-        return "[UnexpectedJSONParseError]: " + error.message;
-      }
-    };
-  }
-});
-
-// ../../node_modules/has-flag/index.js
-var require_has_flag = __commonJS({
-  "../../node_modules/has-flag/index.js"(exports, module) {
-    module.exports = (flag, argv = process.argv) => {
-      const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
-      const position = argv.indexOf(prefix + flag);
-      const terminatorPosition = argv.indexOf("--");
-      return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
-    };
-  }
-});
-
-// ../../node_modules/supports-color/index.js
-var require_supports_color = __commonJS({
-  "../../node_modules/supports-color/index.js"(exports, module) {
-    var os = __require("os");
-    var tty = __require("tty");
-    var hasFlag = require_has_flag();
-    var { env } = process;
-    var forceColor;
-    if (hasFlag("no-color") || hasFlag("no-colors") || hasFlag("color=false") || hasFlag("color=never")) {
-      forceColor = 0;
-    } else if (hasFlag("color") || hasFlag("colors") || hasFlag("color=true") || hasFlag("color=always")) {
-      forceColor = 1;
-    }
-    if ("FORCE_COLOR" in env) {
-      if (env.FORCE_COLOR === "true") {
-        forceColor = 1;
-      } else if (env.FORCE_COLOR === "false") {
-        forceColor = 0;
-      } else {
-        forceColor = env.FORCE_COLOR.length === 0 ? 1 : Math.min(parseInt(env.FORCE_COLOR, 10), 3);
-      }
-    }
-    function translateLevel(level) {
-      if (level === 0) {
-        return false;
-      }
-      return {
-        level,
-        hasBasic: true,
-        has256: level >= 2,
-        has16m: level >= 3
-      };
-    }
-    function supportsColor(haveStream, streamIsTTY) {
-      if (forceColor === 0) {
-        return 0;
-      }
-      if (hasFlag("color=16m") || hasFlag("color=full") || hasFlag("color=truecolor")) {
-        return 3;
-      }
-      if (hasFlag("color=256")) {
-        return 2;
-      }
-      if (haveStream && !streamIsTTY && forceColor === void 0) {
-        return 0;
-      }
-      const min = forceColor || 0;
-      if (env.TERM === "dumb") {
-        return min;
-      }
-      if (process.platform === "win32") {
-        const osRelease = os.release().split(".");
-        if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
-          return Number(osRelease[2]) >= 14931 ? 3 : 2;
-        }
-        return 1;
-      }
-      if ("CI" in env) {
-        if (["TRAVIS", "CIRCLECI", "APPVEYOR", "GITLAB_CI", "GITHUB_ACTIONS", "BUILDKITE"].some((sign) => sign in env) || env.CI_NAME === "codeship") {
-          return 1;
-        }
-        return min;
-      }
-      if ("TEAMCITY_VERSION" in env) {
-        return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(env.TEAMCITY_VERSION) ? 1 : 0;
-      }
-      if (env.COLORTERM === "truecolor") {
-        return 3;
-      }
-      if ("TERM_PROGRAM" in env) {
-        const version = parseInt((env.TERM_PROGRAM_VERSION || "").split(".")[0], 10);
-        switch (env.TERM_PROGRAM) {
-          case "iTerm.app":
-            return version >= 3 ? 3 : 2;
-          case "Apple_Terminal":
-            return 2;
-        }
-      }
-      if (/-256(color)?$/i.test(env.TERM)) {
-        return 2;
-      }
-      if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(env.TERM)) {
-        return 1;
-      }
-      if ("COLORTERM" in env) {
-        return 1;
-      }
-      return min;
-    }
-    function getSupportLevel(stream) {
-      const level = supportsColor(stream, stream && stream.isTTY);
-      return translateLevel(level);
-    }
-    module.exports = {
-      supportsColor: getSupportLevel,
-      stdout: translateLevel(supportsColor(true, tty.isatty(1))),
-      stderr: translateLevel(supportsColor(true, tty.isatty(2)))
-    };
-  }
-});
-
-// ../../node_modules/debug/src/node.js
-var require_node = __commonJS({
-  "../../node_modules/debug/src/node.js"(exports, module) {
-    var tty = __require("tty");
-    var util = __require("util");
-    exports.init = init;
-    exports.log = log;
-    exports.formatArgs = formatArgs;
-    exports.save = save;
-    exports.load = load;
-    exports.useColors = useColors;
-    exports.destroy = util.deprecate(
-      () => {
-      },
-      "Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`."
-    );
-    exports.colors = [6, 2, 3, 4, 5, 1];
-    try {
-      const supportsColor = require_supports_color();
-      if (supportsColor && (supportsColor.stderr || supportsColor).level >= 2) {
-        exports.colors = [
-          20,
-          21,
-          26,
-          27,
-          32,
-          33,
-          38,
-          39,
-          40,
-          41,
-          42,
-          43,
-          44,
-          45,
-          56,
-          57,
-          62,
-          63,
-          68,
-          69,
-          74,
-          75,
-          76,
-          77,
-          78,
-          79,
-          80,
-          81,
-          92,
-          93,
-          98,
-          99,
-          112,
-          113,
-          128,
-          129,
-          134,
-          135,
-          148,
-          149,
-          160,
-          161,
-          162,
-          163,
-          164,
-          165,
-          166,
-          167,
-          168,
-          169,
-          170,
-          171,
-          172,
-          173,
-          178,
-          179,
-          184,
-          185,
-          196,
-          197,
-          198,
-          199,
-          200,
-          201,
-          202,
-          203,
-          204,
-          205,
-          206,
-          207,
-          208,
-          209,
-          214,
-          215,
-          220,
-          221
-        ];
-      }
-    } catch (error) {
-    }
-    exports.inspectOpts = Object.keys(process.env).filter((key) => {
-      return /^debug_/i.test(key);
-    }).reduce((obj, key) => {
-      const prop = key.substring(6).toLowerCase().replace(/_([a-z])/g, (_, k) => {
-        return k.toUpperCase();
-      });
-      let val = process.env[key];
-      if (/^(yes|on|true|enabled)$/i.test(val)) {
-        val = true;
-      } else if (/^(no|off|false|disabled)$/i.test(val)) {
-        val = false;
-      } else if (val === "null") {
-        val = null;
-      } else {
-        val = Number(val);
-      }
-      obj[prop] = val;
-      return obj;
-    }, {});
-    function useColors() {
-      return "colors" in exports.inspectOpts ? Boolean(exports.inspectOpts.colors) : tty.isatty(process.stderr.fd);
-    }
-    function formatArgs(args) {
-      const { namespace: name, useColors: useColors2 } = this;
-      if (useColors2) {
-        const c = this.color;
-        const colorCode = "\x1B[3" + (c < 8 ? c : "8;5;" + c);
-        const prefix = `  ${colorCode};1m${name} \x1B[0m`;
-        args[0] = prefix + args[0].split("\n").join("\n" + prefix);
-        args.push(colorCode + "m+" + module.exports.humanize(this.diff) + "\x1B[0m");
-      } else {
-        args[0] = getDate() + name + " " + args[0];
-      }
-    }
-    function getDate() {
-      if (exports.inspectOpts.hideDate) {
-        return "";
-      }
-      return (/* @__PURE__ */ new Date()).toISOString() + " ";
-    }
-    function log(...args) {
-      return process.stderr.write(util.formatWithOptions(exports.inspectOpts, ...args) + "\n");
-    }
-    function save(namespaces) {
-      if (namespaces) {
-        process.env.DEBUG = namespaces;
-      } else {
-        delete process.env.DEBUG;
-      }
-    }
-    function load() {
-      return process.env.DEBUG;
-    }
-    function init(debug) {
-      debug.inspectOpts = {};
-      const keys = Object.keys(exports.inspectOpts);
-      for (let i = 0; i < keys.length; i++) {
-        debug.inspectOpts[keys[i]] = exports.inspectOpts[keys[i]];
-      }
-    }
-    module.exports = require_common()(exports);
-    var { formatters } = module.exports;
-    formatters.o = function(v) {
-      this.inspectOpts.colors = this.useColors;
-      return util.inspect(v, this.inspectOpts).split("\n").map((str) => str.trim()).join(" ");
-    };
-    formatters.O = function(v) {
-      this.inspectOpts.colors = this.useColors;
-      return util.inspect(v, this.inspectOpts);
-    };
-  }
-});
-
-// ../../node_modules/debug/src/index.js
-var require_src = __commonJS({
-  "../../node_modules/debug/src/index.js"(exports, module) {
-    if (typeof process === "undefined" || process.type === "renderer" || process.browser === true || process.__nwjs) {
-      module.exports = require_browser();
-    } else {
-      module.exports = require_node();
-    }
-  }
-});
-
-// ../../node_modules/follow-redirects/debug.js
-var require_debug = __commonJS({
-  "../../node_modules/follow-redirects/debug.js"(exports, module) {
-    var debug;
-    module.exports = function() {
-      if (!debug) {
-        try {
-          debug = require_src()("follow-redirects");
-        } catch (error) {
-        }
-        if (typeof debug !== "function") {
-          debug = function() {
-          };
-        }
-      }
-      debug.apply(null, arguments);
-    };
-  }
-});
-
-// ../../node_modules/follow-redirects/index.js
-var require_follow_redirects = __commonJS({
-  "../../node_modules/follow-redirects/index.js"(exports, module) {
-    var url = __require("url");
-    var URL2 = url.URL;
-    var http = __require("http");
-    var https = __require("https");
-    var Writable = __require("stream").Writable;
-    var assert = __require("assert");
-    var debug = require_debug();
-    (function detectUnsupportedEnvironment() {
-      var looksLikeNode = typeof process !== "undefined";
-      var looksLikeBrowser = typeof window !== "undefined" && typeof document !== "undefined";
-      var looksLikeV8 = isFunction(Error.captureStackTrace);
-      if (!looksLikeNode && (looksLikeBrowser || !looksLikeV8)) {
-        console.warn("The follow-redirects package should be excluded from browser builds.");
-      }
-    })();
-    var useNativeURL = false;
-    try {
-      assert(new URL2(""));
-    } catch (error) {
-      useNativeURL = error.code === "ERR_INVALID_URL";
-    }
-    var sensitiveHeaders = [
-      "Authorization",
-      "Proxy-Authorization",
-      "Cookie"
-    ];
-    var preservedUrlFields = [
-      "auth",
-      "host",
-      "hostname",
-      "href",
-      "path",
-      "pathname",
-      "port",
-      "protocol",
-      "query",
-      "search",
-      "hash"
-    ];
-    var events = ["abort", "aborted", "connect", "error", "socket", "timeout"];
-    var eventHandlers = /* @__PURE__ */ Object.create(null);
-    events.forEach(function(event) {
-      eventHandlers[event] = function(arg1, arg2, arg3) {
-        this._redirectable.emit(event, arg1, arg2, arg3);
-      };
-    });
-    var InvalidUrlError = createErrorType(
-      "ERR_INVALID_URL",
-      "Invalid URL",
-      TypeError
-    );
-    var RedirectionError = createErrorType(
-      "ERR_FR_REDIRECTION_FAILURE",
-      "Redirected request failed"
-    );
-    var TooManyRedirectsError = createErrorType(
-      "ERR_FR_TOO_MANY_REDIRECTS",
-      "Maximum number of redirects exceeded",
-      RedirectionError
-    );
-    var MaxBodyLengthExceededError = createErrorType(
-      "ERR_FR_MAX_BODY_LENGTH_EXCEEDED",
-      "Request body larger than maxBodyLength limit"
-    );
-    var WriteAfterEndError = createErrorType(
-      "ERR_STREAM_WRITE_AFTER_END",
-      "write after end"
-    );
-    var destroy = Writable.prototype.destroy || noop;
-    function RedirectableRequest(options, responseCallback) {
-      Writable.call(this);
-      this._sanitizeOptions(options);
-      this._options = options;
-      this._ended = false;
-      this._ending = false;
-      this._redirectCount = 0;
-      this._redirects = [];
-      this._requestBodyLength = 0;
-      this._requestBodyBuffers = [];
-      if (responseCallback) {
-        this.on("response", responseCallback);
-      }
-      var self = this;
-      this._onNativeResponse = function(response) {
-        try {
-          self._processResponse(response);
-        } catch (cause) {
-          self.emit("error", cause instanceof RedirectionError ? cause : new RedirectionError({ cause }));
-        }
-      };
-      this._headerFilter = new RegExp("^(?:" + sensitiveHeaders.concat(options.sensitiveHeaders).map(escapeRegex).join("|") + ")$", "i");
-      this._performRequest();
-    }
-    RedirectableRequest.prototype = Object.create(Writable.prototype);
-    RedirectableRequest.prototype.abort = function() {
-      destroyRequest(this._currentRequest);
-      this._currentRequest.abort();
-      this.emit("abort");
-    };
-    RedirectableRequest.prototype.destroy = function(error) {
-      destroyRequest(this._currentRequest, error);
-      destroy.call(this, error);
-      return this;
-    };
-    RedirectableRequest.prototype.write = function(data, encoding, callback) {
-      if (this._ending) {
-        throw new WriteAfterEndError();
-      }
-      if (!isString(data) && !isBuffer(data)) {
-        throw new TypeError("data should be a string, Buffer or Uint8Array");
-      }
-      if (isFunction(encoding)) {
-        callback = encoding;
-        encoding = null;
-      }
-      if (data.length === 0) {
-        if (callback) {
-          callback();
-        }
-        return;
-      }
-      if (this._requestBodyLength + data.length <= this._options.maxBodyLength) {
-        this._requestBodyLength += data.length;
-        this._requestBodyBuffers.push({ data, encoding });
-        this._currentRequest.write(data, encoding, callback);
-      } else {
-        this.emit("error", new MaxBodyLengthExceededError());
-        this.abort();
-      }
-    };
-    RedirectableRequest.prototype.end = function(data, encoding, callback) {
-      if (isFunction(data)) {
-        callback = data;
-        data = encoding = null;
-      } else if (isFunction(encoding)) {
-        callback = encoding;
-        encoding = null;
-      }
-      if (!data) {
-        this._ended = this._ending = true;
-        this._currentRequest.end(null, null, callback);
-      } else {
-        var self = this;
-        var currentRequest = this._currentRequest;
-        this.write(data, encoding, function() {
-          self._ended = true;
-          currentRequest.end(null, null, callback);
-        });
-        this._ending = true;
-      }
-    };
-    RedirectableRequest.prototype.setHeader = function(name, value) {
-      this._options.headers[name] = value;
-      this._currentRequest.setHeader(name, value);
-    };
-    RedirectableRequest.prototype.removeHeader = function(name) {
-      delete this._options.headers[name];
-      this._currentRequest.removeHeader(name);
-    };
-    RedirectableRequest.prototype.setTimeout = function(msecs, callback) {
-      var self = this;
-      function destroyOnTimeout(socket) {
-        socket.setTimeout(msecs);
-        socket.removeListener("timeout", socket.destroy);
-        socket.addListener("timeout", socket.destroy);
-      }
-      function startTimer(socket) {
-        if (self._timeout) {
-          clearTimeout(self._timeout);
-        }
-        self._timeout = setTimeout(function() {
-          self.emit("timeout");
-          clearTimer();
-        }, msecs);
-        destroyOnTimeout(socket);
-      }
-      function clearTimer() {
-        if (self._timeout) {
-          clearTimeout(self._timeout);
-          self._timeout = null;
-        }
-        self.removeListener("abort", clearTimer);
-        self.removeListener("error", clearTimer);
-        self.removeListener("response", clearTimer);
-        self.removeListener("close", clearTimer);
-        if (callback) {
-          self.removeListener("timeout", callback);
-        }
-        if (!self.socket) {
-          self._currentRequest.removeListener("socket", startTimer);
-        }
-      }
-      if (callback) {
-        this.on("timeout", callback);
-      }
-      if (this.socket) {
-        startTimer(this.socket);
-      } else {
-        this._currentRequest.once("socket", startTimer);
-      }
-      this.on("socket", destroyOnTimeout);
-      this.on("abort", clearTimer);
-      this.on("error", clearTimer);
-      this.on("response", clearTimer);
-      this.on("close", clearTimer);
-      return this;
-    };
-    [
-      "flushHeaders",
-      "getHeader",
-      "setNoDelay",
-      "setSocketKeepAlive"
-    ].forEach(function(method) {
-      RedirectableRequest.prototype[method] = function(a, b) {
-        return this._currentRequest[method](a, b);
-      };
-    });
-    ["aborted", "connection", "socket"].forEach(function(property) {
-      Object.defineProperty(RedirectableRequest.prototype, property, {
-        get: function() {
-          return this._currentRequest[property];
-        }
-      });
-    });
-    RedirectableRequest.prototype._sanitizeOptions = function(options) {
-      if (!options.headers) {
-        options.headers = {};
-      }
-      if (!isArray(options.sensitiveHeaders)) {
-        options.sensitiveHeaders = [];
-      }
-      if (options.host) {
-        if (!options.hostname) {
-          options.hostname = options.host;
-        }
-        delete options.host;
-      }
-      if (!options.pathname && options.path) {
-        var searchPos = options.path.indexOf("?");
-        if (searchPos < 0) {
-          options.pathname = options.path;
-        } else {
-          options.pathname = options.path.substring(0, searchPos);
-          options.search = options.path.substring(searchPos);
-        }
-      }
-    };
-    RedirectableRequest.prototype._performRequest = function() {
-      var protocol = this._options.protocol;
-      var nativeProtocol = this._options.nativeProtocols[protocol];
-      if (!nativeProtocol) {
-        throw new TypeError("Unsupported protocol " + protocol);
-      }
-      if (this._options.agents) {
-        var scheme = protocol.slice(0, -1);
-        this._options.agent = this._options.agents[scheme];
-      }
-      var request = this._currentRequest = nativeProtocol.request(this._options, this._onNativeResponse);
-      request._redirectable = this;
-      for (var event of events) {
-        request.on(event, eventHandlers[event]);
-      }
-      this._currentUrl = /^\//.test(this._options.path) ? url.format(this._options) : (
-        // When making a request to a proxy, […]
-        // a client MUST send the target URI in absolute-form […].
-        this._options.path
-      );
-      if (this._isRedirect) {
-        var i = 0;
-        var self = this;
-        var buffers = this._requestBodyBuffers;
-        (function writeNext(error) {
-          if (request === self._currentRequest) {
-            if (error) {
-              self.emit("error", error);
-            } else if (i < buffers.length) {
-              var buffer = buffers[i++];
-              if (!request.finished) {
-                request.write(buffer.data, buffer.encoding, writeNext);
-              }
-            } else if (self._ended) {
-              request.end();
-            }
-          }
-        })();
-      }
-    };
-    RedirectableRequest.prototype._processResponse = function(response) {
-      var statusCode = response.statusCode;
-      if (this._options.trackRedirects) {
-        this._redirects.push({
-          url: this._currentUrl,
-          headers: response.headers,
-          statusCode
-        });
-      }
-      var location = response.headers.location;
-      if (!location || this._options.followRedirects === false || statusCode < 300 || statusCode >= 400) {
-        response.responseUrl = this._currentUrl;
-        response.redirects = this._redirects;
-        this.emit("response", response);
-        this._requestBodyBuffers = [];
-        return;
-      }
-      destroyRequest(this._currentRequest);
-      response.destroy();
-      if (++this._redirectCount > this._options.maxRedirects) {
-        throw new TooManyRedirectsError();
-      }
-      var requestHeaders;
-      var beforeRedirect = this._options.beforeRedirect;
-      if (beforeRedirect) {
-        requestHeaders = Object.assign({
-          // The Host header was set by nativeProtocol.request
-          Host: response.req.getHeader("host")
-        }, this._options.headers);
-      }
-      var method = this._options.method;
-      if ((statusCode === 301 || statusCode === 302) && this._options.method === "POST" || // RFC7231§6.4.4: The 303 (See Other) status code indicates that
-      // the server is redirecting the user agent to a different resource […]
-      // A user agent can perform a retrieval request targeting that URI
-      // (a GET or HEAD request if using HTTP) […]
-      statusCode === 303 && !/^(?:GET|HEAD)$/.test(this._options.method)) {
-        this._options.method = "GET";
-        this._requestBodyBuffers = [];
-        removeMatchingHeaders(/^content-/i, this._options.headers);
-      }
-      var currentHostHeader = removeMatchingHeaders(/^host$/i, this._options.headers);
-      var currentUrlParts = parseUrl(this._currentUrl);
-      var currentHost = currentHostHeader || currentUrlParts.host;
-      var currentUrl = /^\w+:/.test(location) ? this._currentUrl : url.format(Object.assign(currentUrlParts, { host: currentHost }));
-      var redirectUrl = resolveUrl(location, currentUrl);
-      debug("redirecting to", redirectUrl.href);
-      this._isRedirect = true;
-      spreadUrlObject(redirectUrl, this._options);
-      if (redirectUrl.protocol !== currentUrlParts.protocol && redirectUrl.protocol !== "https:" || redirectUrl.host !== currentHost && !isSubdomain(redirectUrl.host, currentHost)) {
-        removeMatchingHeaders(this._headerFilter, this._options.headers);
-      }
-      if (isFunction(beforeRedirect)) {
-        var responseDetails = {
-          headers: response.headers,
-          statusCode
-        };
-        var requestDetails = {
-          url: currentUrl,
-          method,
-          headers: requestHeaders
-        };
-        beforeRedirect(this._options, responseDetails, requestDetails);
-        this._sanitizeOptions(this._options);
-      }
-      this._performRequest();
-    };
-    function wrap(protocols) {
-      var exports2 = {
-        maxRedirects: 21,
-        maxBodyLength: 10 * 1024 * 1024
-      };
-      var nativeProtocols = {};
-      Object.keys(protocols).forEach(function(scheme) {
-        var protocol = scheme + ":";
-        var nativeProtocol = nativeProtocols[protocol] = protocols[scheme];
-        var wrappedProtocol = exports2[scheme] = Object.create(nativeProtocol);
-        function request(input, options, callback) {
-          if (isURL(input)) {
-            input = spreadUrlObject(input);
-          } else if (isString(input)) {
-            input = spreadUrlObject(parseUrl(input));
-          } else {
-            callback = options;
-            options = validateUrl(input);
-            input = { protocol };
-          }
-          if (isFunction(options)) {
-            callback = options;
-            options = null;
-          }
-          options = Object.assign({
-            maxRedirects: exports2.maxRedirects,
-            maxBodyLength: exports2.maxBodyLength
-          }, input, options);
-          options.nativeProtocols = nativeProtocols;
-          if (!isString(options.host) && !isString(options.hostname)) {
-            options.hostname = "::1";
-          }
-          assert.equal(options.protocol, protocol, "protocol mismatch");
-          debug("options", options);
-          return new RedirectableRequest(options, callback);
-        }
-        function get(input, options, callback) {
-          var wrappedRequest = wrappedProtocol.request(input, options, callback);
-          wrappedRequest.end();
-          return wrappedRequest;
-        }
-        Object.defineProperties(wrappedProtocol, {
-          request: { value: request, configurable: true, enumerable: true, writable: true },
-          get: { value: get, configurable: true, enumerable: true, writable: true }
-        });
-      });
-      return exports2;
-    }
-    function noop() {
-    }
-    function parseUrl(input) {
-      var parsed;
-      if (useNativeURL) {
-        parsed = new URL2(input);
-      } else {
-        parsed = validateUrl(url.parse(input));
-        if (!isString(parsed.protocol)) {
-          throw new InvalidUrlError({ input });
-        }
-      }
-      return parsed;
-    }
-    function resolveUrl(relative, base) {
-      return useNativeURL ? new URL2(relative, base) : parseUrl(url.resolve(base, relative));
-    }
-    function validateUrl(input) {
-      if (/^\[/.test(input.hostname) && !/^\[[:0-9a-f]+\]$/i.test(input.hostname)) {
-        throw new InvalidUrlError({ input: input.href || input });
-      }
-      if (/^\[/.test(input.host) && !/^\[[:0-9a-f]+\](:\d+)?$/i.test(input.host)) {
-        throw new InvalidUrlError({ input: input.href || input });
-      }
-      return input;
+  let totalOut = 0;
+  let cachedTokensEstimate = 0;
+  for (const r of results) {
+    allIssues.push(...r.issues);
+    if (r.pass) {
+      passCategories.push(r.criterion);
     }
-    function spreadUrlObject(urlObject, target) {
-      var spread = target || {};
-      for (var key of preservedUrlFields) {
-        spread[key] = urlObject[key];
-      }
-      if (spread.hostname.startsWith("[")) {
-        spread.hostname = spread.hostname.slice(1, -1);
+    totalIn += r.tokens.in;
+    totalOut += r.tokens.out;
+  }
+  const firstResult = results[0];
+  if (firstResult && firstResult.tokens.in > 0) {
+    cachedTokensEstimate = firstResult.tokens.in * (totalCriteriaCount - 1);
+  }
+  const wallMs = Date.now() - evalStart;
+  for (const r of results) {
+    const issueCount = r.issues.length;
+    const status = r.pass ? "PASS" : r.tier === 1 ? "FAIL" : r.issues.some((i) => i.result === "fail") ? "FAIL" : "WARN";
+    const issueLabel = issueCount > 0 ? ` (${issueCount} issue${issueCount > 1 ? "s" : ""})` : "";
+    console.log(`[eval] ${r.criterion}: ${status}${issueLabel} ${(r.durationMs / 1e3).toFixed(1)}s`);
+  }
+  console.log(
+    `[eval] total: ${(wallMs / 1e3).toFixed(1)}s wall (${totalCriteriaCount} parallel) | in=${totalIn} out=${totalOut} cached~=${cachedTokensEstimate} | issues=${allIssues.length} pass=${passCategories.length}`
+  );
+  return {
+    issues: allIssues,
+    pass: passCategories,
+    inputTokens: totalIn,
+    outputTokens: totalOut
+  };
+}
+var TIER_1_CRITERIA, TIER_2_CRITERIA, TIER_1_CATEGORIES, TIER_2_CATEGORIES, VALID_CATEGORIES;
+var init_llm_evaluator = __esm({
+  "src/evaluation/llm-evaluator.ts"() {
+    init_llm_router();
+    init_types_public();
+    TIER_1_CRITERIA = ["functionality", "crash"];
+    TIER_2_CRITERIA = ["interactivity", "accessibility", "layout", "loading", "visual"];
+    TIER_1_CATEGORIES = /* @__PURE__ */ new Set(["functionality", "crash"]);
+    TIER_2_CATEGORIES = /* @__PURE__ */ new Set([
+      "interactivity",
+      "accessibility",
+      "layout",
+      "loading",
+      "visual"
+    ]);
+    VALID_CATEGORIES = /* @__PURE__ */ new Set([
+      ...TIER_1_CATEGORIES,
+      ...TIER_2_CATEGORIES
+    ]);
+  }
+});
+
+// src/evaluation/cost-tracker.ts
+var cost_tracker_exports = {};
+__export(cost_tracker_exports, {
+  CostTracker: () => CostTracker,
+  pricePer1k: () => pricePer1k
+});
+function resolveRegistryId(model) {
+  const keys = Object.keys(MODEL_REGISTRY);
+  if (keys.includes(model)) return model;
+  const bySuffix = keys.find((id) => id.endsWith(`/${model}`));
+  if (bySuffix) return bySuffix;
+  const undated = model.replace(/-\d{8}$/, "");
+  return keys.find((id) => id.endsWith(`/${undated}`)) ?? null;
+}
+function pricePer1k(model) {
+  const id = resolveRegistryId(model);
+  if (id === null) return FALLBACK_PER_1K;
+  const { costs } = MODEL_REGISTRY[id];
+  return { input: costs.inputPer1M / 1e3, output: costs.outputPer1M / 1e3 };
+}
+var FALLBACK_PER_1K, CostTracker;
+var init_cost_tracker = __esm({
+  "src/evaluation/cost-tracker.ts"() {
+    FALLBACK_PER_1K = { input: 3e-3, output: 0.015 };
+    CostTracker = class {
+      constructor(maxBudget) {
+        this.maxBudget = maxBudget;
       }
-      if (spread.port !== "") {
-        spread.port = Number(spread.port);
+      maxBudget;
+      totalCost = 0;
+      record(model, inputTokens, outputTokens) {
+        const prices = pricePer1k(model);
+        const cost = inputTokens / 1e3 * prices.input + outputTokens / 1e3 * prices.output;
+        this.totalCost += cost;
+        return cost;
       }
-      spread.path = spread.search ? spread.pathname + spread.search : spread.pathname;
-      return spread;
-    }
-    function removeMatchingHeaders(regex, headers) {
-      var lastValue;
-      for (var header in headers) {
-        if (regex.test(header)) {
-          lastValue = headers[header];
-          delete headers[header];
-        }
+      canContinue() {
+        if (this.maxBudget === null) return true;
+        return this.totalCost < this.maxBudget;
       }
-      return lastValue === null || typeof lastValue === "undefined" ? void 0 : String(lastValue).trim();
-    }
-    function createErrorType(code, message, baseClass) {
-      function CustomError(properties) {
-        if (isFunction(Error.captureStackTrace)) {
-          Error.captureStackTrace(this, this.constructor);
-        }
-        Object.assign(this, properties || {});
-        this.code = code;
-        this.message = this.cause ? message + ": " + this.cause.message : message;
+      getTotal() {
+        return this.totalCost;
       }
-      CustomError.prototype = new (baseClass || Error)();
-      Object.defineProperties(CustomError.prototype, {
-        constructor: {
-          value: CustomError,
-          enumerable: false
-        },
-        name: {
-          value: "Error [" + code + "]",
-          enumerable: false
-        }
-      });
-      return CustomError;
-    }
-    function destroyRequest(request, error) {
-      for (var event of events) {
-        request.removeListener(event, eventHandlers[event]);
+      getRemaining() {
+        if (this.maxBudget === null) return null;
+        return Math.max(0, this.maxBudget - this.totalCost);
       }
-      request.on("error", noop);
-      request.destroy(error);
-    }
-    function isSubdomain(subdomain, domain) {
-      assert(isString(subdomain) && isString(domain));
-      var dot = subdomain.length - domain.length - 1;
-      return dot > 0 && subdomain[dot] === "." && subdomain.endsWith(domain);
-    }
-    function isArray(value) {
-      return value instanceof Array;
-    }
-    function isString(value) {
-      return typeof value === "string" || value instanceof String;
-    }
-    function isFunction(value) {
-      return typeof value === "function";
-    }
-    function isBuffer(value) {
-      return typeof value === "object" && "length" in value;
-    }
-    function isURL(value) {
-      return URL2 && value instanceof URL2;
-    }
-    function escapeRegex(regex) {
-      return regex.replace(/[\]\\/()*+?.$]/g, "\\$&");
-    }
-    module.exports = wrap({ http, https });
-    module.exports.wrap = wrap;
+    };
   }
 });
 
@@ -8539,7 +7519,7 @@ var require_streamx = __commonJS({
         }
       }
     };
-    var Readable = class _Readable extends Stream {
+    var Readable2 = class _Readable extends Stream {
       constructor(opts) {
         super(opts);
         this._duplexState |= OPENING | WRITE_DONE | READ_READ_AHEAD;
@@ -8556,7 +7536,7 @@ var require_streamx = __commonJS({
         fn().then((src) => {
           if (src === null) return out.end();
           if (out.destroying) return;
-          pipeline(src, out, noop);
+          pipeline2(src, out, noop);
         }).catch((err) => out.destroy(err));
         return out;
       }
@@ -8750,7 +7730,7 @@ var require_streamx = __commonJS({
         return this;
       }
     };
-    var Duplex = class extends Readable {
+    var Duplex = class extends Readable2 {
       // and Writable
       constructor(opts) {
         super(opts);
@@ -8843,13 +7823,13 @@ var require_streamx = __commonJS({
     }
     function pipelinePromise(...streams) {
       return new Promise((resolve3, reject) => {
-        return pipeline(...streams, (err) => {
+        return pipeline2(...streams, (err) => {
           if (err) return reject(err);
           resolve3();
         });
       });
     }
-    function pipeline(stream, ...streams) {
+    function pipeline2(stream, ...streams) {
       const all = Array.isArray(stream) ? [...stream, ...streams] : [stream, ...streams];
       const done = all.length && typeof all[all.length - 1] === "function" ? all.pop() : null;
       if (all.length < 2) throw StreamError.BAD_ARGUMENT("Pipeline requires at least 2 streams");
@@ -8947,7 +7927,7 @@ var require_streamx = __commonJS({
       return s._writev !== Writable.prototype._writev && s._writev !== Duplex.prototype._writev;
     }
     module.exports = {
-      pipeline,
+      pipeline: pipeline2,
       pipelinePromise,
       isStream,
       isStreamx,
@@ -8959,7 +7939,7 @@ var require_streamx = __commonJS({
       getStreamError,
       Stream,
       Writable,
-      Readable,
+      Readable: Readable2,
       Duplex,
       Transform,
       // Export PassThrough for compatibility with Node.js core's stream module
@@ -8968,9 +7948,9 @@ var require_streamx = __commonJS({
   }
 });
 
-// ../../node_modules/tar-fs/node_modules/tar-stream/headers.js
+// ../../node_modules/@sparticuz/chromium/node_modules/tar-stream/headers.js
 var require_headers = __commonJS({
-  "../../node_modules/tar-fs/node_modules/tar-stream/headers.js"(exports) {
+  "../../node_modules/@sparticuz/chromium/node_modules/tar-stream/headers.js"(exports) {
     var b4a = require_b4a();
     var ZEROS = "0000000000000000000";
     var SEVENS = "7777777777777777777";
@@ -9228,10 +8208,10 @@ var require_headers = __commonJS({
   }
 });
 
-// ../../node_modules/tar-fs/node_modules/tar-stream/extract.js
+// ../../node_modules/@sparticuz/chromium/node_modules/tar-stream/extract.js
 var require_extract = __commonJS({
-  "../../node_modules/tar-fs/node_modules/tar-stream/extract.js"(exports, module) {
-    var { Writable, Readable, getStreamError } = require_streamx();
+  "../../node_modules/@sparticuz/chromium/node_modules/tar-stream/extract.js"(exports, module) {
+    var { Writable, Readable: Readable2, getStreamError } = require_streamx();
     var FIFO = require_fast_fifo();
     var b4a = require_b4a();
     var headers = require_headers();
@@ -9278,7 +8258,7 @@ var require_extract = __commonJS({
         return buf.subarray(this._offset, this._offset += size);
       }
     };
-    var Source = class extends Readable {
+    var Source = class extends Readable2 {
       constructor(self, header, offset) {
         super();
         this.header = header;
@@ -9562,9 +8542,9 @@ var require_extract = __commonJS({
   }
 });
 
-// ../../node_modules/tar-fs/node_modules/tar-stream/constants.js
+// ../../node_modules/@sparticuz/chromium/node_modules/tar-stream/constants.js
 var require_constants = __commonJS({
-  "../../node_modules/tar-fs/node_modules/tar-stream/constants.js"(exports, module) {
+  "../../node_modules/@sparticuz/chromium/node_modules/tar-stream/constants.js"(exports, module) {
     var constants = {
       // just for envs without fs
       S_IFMT: 61440,
@@ -9582,10 +8562,10 @@ var require_constants = __commonJS({
   }
 });
 
-// ../../node_modules/tar-fs/node_modules/tar-stream/pack.js
+// ../../node_modules/@sparticuz/chromium/node_modules/tar-stream/pack.js
 var require_pack = __commonJS({
-  "../../node_modules/tar-fs/node_modules/tar-stream/pack.js"(exports, module) {
-    var { Readable, Writable, getStreamError } = require_streamx();
+  "../../node_modules/@sparticuz/chromium/node_modules/tar-stream/pack.js"(exports, module) {
+    var { Readable: Readable2, Writable, getStreamError } = require_streamx();
     var b4a = require_b4a();
     var constants = require_constants();
     var headers = require_headers();
@@ -9678,7 +8658,7 @@ var require_pack = __commonJS({
         cb();
       }
     };
-    var Pack = class extends Readable {
+    var Pack = class extends Readable2 {
       constructor(opts) {
         super(opts);
         this._drain = noop;
@@ -9816,9 +8796,9 @@ var require_pack = __commonJS({
   }
 });
 
-// ../../node_modules/tar-fs/node_modules/tar-stream/index.js
+// ../../node_modules/@sparticuz/chromium/node_modules/tar-stream/index.js
 var require_tar_stream = __commonJS({
-  "../../node_modules/tar-fs/node_modules/tar-stream/index.js"(exports) {
+  "../../node_modules/@sparticuz/chromium/node_modules/tar-stream/index.js"(exports) {
     exports.extract = require_extract();
     exports.pack = require_pack();
   }
@@ -10056,9 +9036,9 @@ var require_pump = __commonJS({
   }
 });
 
-// ../../node_modules/tar-fs/index.js
+// ../../node_modules/@sparticuz/chromium/node_modules/tar-fs/index.js
 var require_tar_fs = __commonJS({
-  "../../node_modules/tar-fs/index.js"(exports) {
+  "../../node_modules/@sparticuz/chromium/node_modules/tar-fs/index.js"(exports) {
     var tar = require_tar_stream();
     var pump = require_pump();
     var fs2 = __require("fs");
@@ -10384,10 +9364,9 @@ var require_tar_fs = __commonJS({
     }
   }
 });
-var import_follow_redirects, import_tar_fs, setupLambdaEnvironment, isValidUrl, isRunningInAmazonLinux2023, downloadAndExtract;
+var import_tar_fs, setupLambdaEnvironment, isValidUrl, isRunningInAmazonLinux2023, downloadAndExtract;
 var init_helper = __esm({
-  "../../node_modules/@sparticuz/chromium/build/esm/helper.js"() {
-    import_follow_redirects = __toESM(require_follow_redirects());
+  "../../node_modules/@sparticuz/chromium/build/helper.js"() {
     import_tar_fs = __toESM(require_tar_fs());
     setupLambdaEnvironment = (baseLibPath) => {
       process.env["FONTCONFIG_PATH"] ??= join(tmpdir(), "fonts");
@@ -10403,7 +9382,13 @@ var init_helper = __esm({
     };
     isValidUrl = (input) => {
       try {
-        return Boolean(new URL(input));
+        const url = new URL(input);
+        if (url.protocol === "https:")
+          return true;
+        if (url.protocol === "http:" && (url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "[::1]")) {
+          return true;
+        }
+        return false;
       } catch {
         return false;
       }
@@ -10421,43 +9406,41 @@ var init_helper = __esm({
       return false;
     };
     downloadAndExtract = async (url) => {
-      const getOptions = new URL(url);
-      getOptions.maxBodyLength = 60 * 1024 * 1024;
       const destDir = join(tmpdir(), "chromium-pack");
-      return new Promise((resolve3, reject) => {
-        const extractObj = (0, import_tar_fs.extract)(destDir);
-        const cleanupOnError = (err) => {
+      const response = await fetch(url, {
+        redirect: "follow",
+        signal: AbortSignal.timeout(3e5)
+      });
+      if (!response.ok) {
+        throw new Error(`Unexpected status code: ${String(response.status)}.`);
+      }
+      if (!response.body) {
+        throw new Error("Response body is empty.");
+      }
+      try {
+        await pipeline(Readable.fromWeb(response.body), (0, import_tar_fs.extract)(destDir));
+      } catch (error) {
+        await new Promise((resolve3) => {
           rm(destDir, { force: true, recursive: true }, () => {
-            reject(err);
+            resolve3();
           });
-        };
-        extractObj.once("error", cleanupOnError);
-        extractObj.once("finish", () => {
-          resolve3(destDir);
-        });
-        const req = import_follow_redirects.default.https.get(url, (response) => {
-          if (response.statusCode !== 200) {
-            reject(new Error(`Unexpected status code: ${response.statusCode?.toFixed(0) ?? "UNK"}.`));
-            return;
-          }
-          response.pipe(extractObj);
-          response.once("error", cleanupOnError);
         });
-        req.once("error", cleanupOnError);
-        req.setTimeout(60 * 1e3, () => {
-          req.destroy();
-          cleanupOnError(new Error("Request timeout"));
-        });
-      });
+        throw error;
+      }
+      return destDir;
     };
   }
 });
-var import_tar_fs2, inflate;
+var import_tar_fs2, ARCHIVE_EXTENSION_REGEX, TAR_EXTENSION_REGEX, BROTLI_EXTENSION_REGEX, GZIP_EXTENSION_REGEX, inflate;
 var init_lambdafs = __esm({
-  "../../node_modules/@sparticuz/chromium/build/esm/lambdafs.js"() {
+  "../../node_modules/@sparticuz/chromium/build/lambdafs.js"() {
     import_tar_fs2 = __toESM(require_tar_fs());
+    ARCHIVE_EXTENSION_REGEX = /\.(?:t(?:ar(?:\.(?:br|gz))?|br|gz)|br|gz)$/i;
+    TAR_EXTENSION_REGEX = /\.t(?:ar(?:\.(?:br|gz))?|br|gz)$/i;
+    BROTLI_EXTENSION_REGEX = /br$/i;
+    GZIP_EXTENSION_REGEX = /gz$/i;
     inflate = (filePath) => {
-      const output = filePath.includes("swiftshader") ? tmpdir() : join(tmpdir(), basename(filePath).replace(/\.(?:t(?:ar(?:\.(?:br|gz))?|br|gz)|br|gz)$/i, ""));
+      const output = filePath.includes("swiftshader") ? tmpdir() : join(tmpdir(), basename(filePath).replace(ARCHIVE_EXTENSION_REGEX, ""));
       return new Promise((resolve3, reject) => {
         if (filePath.includes("swiftshader")) {
           if (existsSync(`${output}/libGLESv2.so`)) {
@@ -10468,9 +9451,9 @@ var init_lambdafs = __esm({
           resolve3(output);
           return;
         }
-        const isBrotli = /br$/i.test(filePath);
-        const isGzip = /gz$/i.test(filePath);
-        const isTar = /\.t(?:ar(?:\.(?:br|gz))?|br|gz)$/i.test(filePath);
+        const isBrotli = BROTLI_EXTENSION_REGEX.test(filePath);
+        const isGzip = GZIP_EXTENSION_REGEX.test(filePath);
+        const isTar = TAR_EXTENSION_REGEX.test(filePath);
         const highWaterMark = 2 ** 22;
         const source = createReadStream(filePath, { highWaterMark });
         let target;
@@ -10502,24 +9485,28 @@ var init_lambdafs = __esm({
   }
 });
 function getBinPath() {
-  return join(dirname(fileURLToPath(import.meta.url)), "..", "..", "bin");
+  return join(dirname(fileURLToPath(import.meta.url)), "..", "bin");
 }
-var init_paths_esm = __esm({
-  "../../node_modules/@sparticuz/chromium/build/esm/paths.esm.js"() {
+var init_paths = __esm({
+  "../../node_modules/@sparticuz/chromium/build/paths.js"() {
   }
 });
 
-// ../../node_modules/@sparticuz/chromium/build/esm/index.js
-var esm_exports = {};
-__export(esm_exports, {
-  default: () => esm_default
+// ../../node_modules/@sparticuz/chromium/build/index.js
+var build_exports = {};
+__export(build_exports, {
+  default: () => build_default,
+  inflate: () => inflate,
+  setupLambdaEnvironment: () => setupLambdaEnvironment
 });
-var nodeMajorVersion, Chromium, esm_default;
-var init_esm = __esm({
-  "../../node_modules/@sparticuz/chromium/build/esm/index.js"() {
+var nodeMajorVersion, Chromium, build_default;
+var init_build = __esm({
+  "../../node_modules/@sparticuz/chromium/build/index.js"() {
+    init_helper();
+    init_lambdafs();
+    init_paths();
     init_helper();
     init_lambdafs();
-    init_paths_esm();
     nodeMajorVersion = Number.parseInt(process.versions.node.split(".")[0] ?? "");
     if (isRunningInAmazonLinux2023(nodeMajorVersion)) {
       setupLambdaEnvironment(join(tmpdir(), "al2023", "lib"));
@@ -10638,7 +9625,7 @@ var init_esm = __esm({
         }
         input ??= getBinPath();
         if (!existsSync(input)) {
-          throw new Error(`The input directory "${input}" does not exist. Please provide the location of the brotli files.`);
+          throw new Error(`The input directory "${input}" does not exist. If you are using a bundler (esbuild, webpack, etc.), you must externalize @sparticuz/chromium so it is not relocated. See: https://github.com/Sparticuz/chromium#bundler-configuration`);
         }
         const promises = [
           inflate(join(input, "chromium.br")),
@@ -10652,7 +9639,7 @@ var init_esm = __esm({
         return result.shift();
       }
     };
-    esm_default = Chromium;
+    build_default = Chromium;
   }
 });
 
@@ -10661,6 +9648,7 @@ var visual_evaluator_exports = {};
 __export(visual_evaluator_exports, {
   buildRenderHTML: () => buildRenderHTML,
   bundleForRendering: () => bundleForRendering,
+  callMultimodalLLM: () => callMultimodalLLM,
   runVisualEval: () => runVisualEval,
   runVisualEvaluation: () => runVisualEvaluation
 });
@@ -10759,7 +9747,7 @@ ${bundledCode}
 async function captureScreenshot(html, viewport = { width: 1280, height: 800 }) {
   try {
     const puppeteer = await import('puppeteer-core');
-    const chromium = await Promise.resolve().then(() => (init_esm(), esm_exports));
+    const chromium = await Promise.resolve().then(() => (init_build(), build_exports));
     const launchOptions = {
       args: chromium.default.args,
       defaultViewport: viewport,
@@ -10769,7 +9757,9 @@ async function captureScreenshot(html, viewport = { width: 1280, height: 800 })
     const browser = await puppeteer.default.launch(launchOptions);
     try {
       const page = await browser.newPage();
-      await page.setContent(html, { waitUntil: "networkidle0", timeout: 15e3 });
+      await page.setContent(html, { waitUntil: "load", timeout: 15e3 });
+      await page.waitForNetworkIdle({ idleTime: 500, timeout: 15e3 }).catch(() => {
+      });
       await page.waitForSelector("#root > *", { timeout: 1e4 }).catch(() => {
       });
       await new Promise((r) => setTimeout(r, 1e3));
@@ -10783,63 +9773,23 @@ async function captureScreenshot(html, viewport = { width: 1280, height: 800 })
     return null;
   }
 }
-async function callMultimodalLLM(provider, model, prompt, screenshot, originalPrompt) {
+async function callMultimodalLLM(config, model, prompt, screenshot, originalPrompt) {
   const userPrompt = `## Original Request
 ${originalPrompt}
 
 Evaluate the screenshot of the generated component.`;
-  if (provider === "claude") {
-    const { default: Anthropic2 } = await import('@anthropic-ai/sdk');
-    const client2 = new Anthropic2({
-      apiKey: process.env.ANTHROPIC_API_KEY,
-      baseURL: "https://api.anthropic.com"
-    });
-    const response2 = await client2.messages.create({
-      model: model.startsWith("anthropic/") ? model.slice(10) : model,
-      max_tokens: 1500,
-      system: prompt,
-      messages: [{
-        role: "user",
-        content: [
-          {
-            type: "image",
-            source: {
-              type: "base64",
-              media_type: "image/png",
-              data: screenshot.toString("base64")
-            }
-          },
-          { type: "text", text: userPrompt }
-        ]
-      }]
-    });
-    return {
-      text: response2.content.filter((b) => b.type === "text").map((b) => b.text).join(""),
-      inputTokens: response2.usage.input_tokens,
-      outputTokens: response2.usage.output_tokens
-    };
-  }
-  const { GoogleGenAI } = await import('@google/genai');
-  const client = new GoogleGenAI({
-    apiKey: process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY
-  });
-  const response = await client.models.generateContent({
-    model: model.startsWith("google/") ? model.slice(7) : model,
-    contents: [{
-      role: "user",
-      parts: [
-        { inlineData: { mimeType: "image/png", data: screenshot.toString("base64") } },
-        { text: userPrompt }
-      ]
-    }],
-    config: { systemInstruction: prompt }
+  const agent = createVisionAgent({
+    provider: config.provider === "claude" ? "anthropic" : config.provider,
+    routeOverride: config.routeOverride,
+    onRetry: config.onRetry
   });
-  const usage = response.usageMetadata;
-  return {
-    text: response.candidates?.[0]?.content?.parts?.map((p) => p.text || "").join("") || "",
-    inputTokens: usage?.promptTokenCount ?? 0,
-    outputTokens: usage?.candidatesTokenCount ?? 0
-  };
+  return agent.callVision(
+    model,
+    prompt,
+    userPrompt,
+    { mediaType: "image/png", base64: screenshot.toString("base64") },
+    1500
+  );
 }
 async function runVisualEvaluation(context, config) {
   const startTime = Date.now();
@@ -10857,7 +9807,7 @@ async function runVisualEvaluation(context, config) {
   console.log(`[visual-eval] screenshot: ${screenshot.length}B (${Date.now() - startTime}ms)`);
   const model = config.model ?? getDefaultVisualModel(config.provider);
   const response = await callMultimodalLLM(
-    config.provider,
+    config,
     model,
     VISUAL_EVAL_PROMPT,
     screenshot,
@@ -10931,6 +9881,7 @@ async function runVisualEval(context, config) {
 var VISUAL_EVAL_PROMPT;
 var init_visual_evaluator = __esm({
   "src/evaluation/visual-evaluator.ts"() {
+    init_llm_router();
     VISUAL_EVAL_PROMPT = `You are a visual quality evaluator for ggui \u2014 a platform where AI agents generate React UI components on demand.
 
 ## Context
@@ -11393,10 +10344,12 @@ These tokens adapt automatically to any theme (light, dark, branded). **ALWAYS u
 - Borders/dividers \u2192 \`var(--ggui-color-outline)\` or \`var(--ggui-color-outlineVariant)\`
 
 ### State Colors
-- var(--ggui-color-success) \u2014 success states
-- var(--ggui-color-warning) \u2014 warning states
-- var(--ggui-color-error) \u2014 error states, destructive actions
-- var(--ggui-color-info) \u2014 informational
+Semantic families ship as SCALES; the \`500\` stop is the role color (per-mode brightness), \`50\` the tint, \`800\` the on-tint text:
+- var(--ggui-color-success-500) \u2014 success states (tint bg: success-50, text on tint: success-800)
+- var(--ggui-color-warning-500) \u2014 warning states (warning-50 / warning-800)
+- var(--ggui-color-error-500) \u2014 error states, destructive actions (error-50 / error-800)
+- var(--ggui-color-info-500) \u2014 informational (info-50 / info-800)
+Prefer the primitives' \`tone="success|warning|error|info"\` prop over hand-written vars \u2014 it resolves to the same stops.
 
 ### IMPORTANT: Color Rules
 - **NEVER** use hardcoded hex colors. ONLY use var(--ggui-color-*) tokens.
@@ -11696,16 +10649,19 @@ function generateSampleProps(spec) {
   return props;
 }
 function synthesizeFromSchema(schema) {
-  switch (schema.type) {
+  const declared = Array.isArray(schema.type) ? schema.type.find((t) => t !== "null") : schema.type;
+  switch (declared) {
     case "string":
       return "sample";
     case "number":
+    case "integer":
       return 0;
     case "boolean":
       return false;
+    case "null":
+      return null;
     case "array": {
-      const itemSchema = schema.items;
-      if (itemSchema) return [synthesizeFromSchema(itemSchema) ?? null];
+      if (schema.items) return [synthesizeFromSchema(schema.items) ?? null];
       return [];
     }
     case "object": {
@@ -13171,11 +12127,11 @@ var stateFragments = {
     axis: "state",
     value: "merge",
     cacheTier: "axisDelta",
-    promptText: "## State: merge (live entity reconciliation)\n1. Seed `const [items, setItems] = useState(props.items ?? [])`.\n2. On stream updates: `setItems(prev => prev.map(it => it.id === event.id ? { ...it, ...event } : it))` \u2014 merge by id, do NOT append.\n3. Memoize derived views (grouping/sorting/filtering) with useMemo.\n4. Per-item actions pass `{ id, ... }` in the payload.\n5. Never push the stream payload into an append-only list unless realtime=append.",
+    promptText: "## State: merge (live entity reconciliation)\n1. Seed `const [items, setItems] = useState(props.items ?? [])` AND re-seed on prop change: `useEffect(() => setItems(props.items ?? []), [props.items])` \u2014 a `ggui_amend` repaint must move the list.\n2. On stream updates: `setItems(prev => prev.map(it => it.id === event.id ? { ...it, ...event } : it))` \u2014 merge by id, do NOT append.\n3. Memoize derived views (grouping/sorting/filtering) with useMemo.\n4. Per-item actions pass `{ id, ... }` in the payload.\n5. Never push the stream payload into an append-only list unless realtime=append.",
     boilerplateMarker: [
       "",
       "  // \u2500\u2500 Live entity state (merge-by-id) \u2500\u2500",
-      "  // useState(props.items ?? []); merge stream events by item.id; never append.",
+      "  // useState(props.items ?? []); re-seed via useEffect on [props.items]; merge stream events by item.id; never append.",
       ""
     ].join("\n")
   },
@@ -13293,13 +12249,13 @@ var realtimeFragments = {
     axis: "realtime",
     value: "merge",
     cacheTier: "axisDelta",
-    promptText: "## Realtime: merge\nStream events carry an id; merge into LOCAL STATE. Subscribing alone is not enough \u2014 the local list must update on each event for the DOM to re-render.\n\n```tsx\nconst stream = useStream<UpdateT>('streamName');\nconst [items, setItems] = useState(props.items);\nuseEffect(() => {\n  if (!stream.latest) return;\n  setItems((prev) => prev.map((it) => it.id === stream.latest!.id ? { ...it, ...stream.latest } : it));\n}, [stream.latest]);\n// Render `items.map(...)` \u2014 NOT props.items, NOT stream.all.\n```\n\nNever append \u2014 stream=merge means the entity already exists locally."
+    promptText: "## Realtime: merge\nStream events carry an id; merge into LOCAL STATE. Subscribing alone is not enough \u2014 the local list must update on each event for the DOM to re-render.\n\n```tsx\nconst stream = useStream<UpdateT>('streamName');\nconst [items, setItems] = useState(props.items);\nuseEffect(() => setItems(props.items), [props.items]); // re-seed on ggui_amend repaint \u2014 props stay the source of truth\nuseEffect(() => {\n  if (!stream.latest) return;\n  setItems((prev) => prev.map((it) => it.id === stream.latest!.id ? { ...it, ...stream.latest } : it));\n}, [stream.latest]);\n// Render `items.map(...)` \u2014 NOT props.items, NOT stream.all.\n```\n\nNever append \u2014 stream=merge means the entity already exists locally."
   },
   append: {
     axis: "realtime",
     value: "append",
     cacheTier: "axisDelta",
-    promptText: "## Realtime: append\nStream events are new entities; APPEND to local state. Subscribing alone is not enough \u2014 the local list must update for the DOM to re-render.\n\n```tsx\nconst stream = useStream<EventT>('streamName');\nconst [items, setItems] = useState(props.items);\nuseEffect(() => {\n  if (!stream.latest) return;\n  setItems((prev) => [...prev, stream.latest!]);\n}, [stream.latest]);\n// Render `items.map(...)` \u2014 NOT props.items, NOT stream.all (which accumulates only post-mount).\n```\n\nUse head for newest-first, tail for chat-style. Cap list length if needed. Do not dedupe unless the contract guarantees at-most-once."
+    promptText: "## Realtime: append\nStream events are new entities; APPEND to local state. Subscribing alone is not enough \u2014 the local list must update for the DOM to re-render.\n\n```tsx\nconst stream = useStream<EventT>('streamName');\nconst [items, setItems] = useState(props.items);\nuseEffect(() => setItems(props.items), [props.items]); // re-seed on ggui_amend repaint \u2014 props stay the source of truth\nuseEffect(() => {\n  if (!stream.latest) return;\n  setItems((prev) => [...prev, stream.latest!]);\n}, [stream.latest]);\n// Render `items.map(...)` \u2014 NOT props.items, NOT stream.all (which accumulates only post-mount).\n```\n\nUse head for newest-first, tail for chat-style. Cap list length if needed. Do not dedupe unless the contract guarantees at-most-once."
   },
   status: {
     axis: "realtime",
@@ -13317,7 +12273,7 @@ var realtimeFragments = {
     axis: "realtime",
     value: "mixed",
     cacheTier: "axisDelta",
-    promptText: "## Realtime: mixed\nMultiple stream channels with DIFFERENT semantics. Each `streamKinds` entry in the contract maps to one of: merge, append, status, presence. Subscribe + sync to local state PER CHANNEL \u2014 subscribing alone never re-renders the DOM.\n\nExample (chat-interface \u2014 message=append, typing=presence):\n\n```tsx\nconst messages = useStream<MessageT>('message');\nconst typing = useStream<TypingT>('typing');\nconst [messageList, setMessageList] = useState(props.messages);\nconst [typingUsers, setTypingUsers] = useState<Set<string>>(new Set());\n\nuseEffect(() => {\n  if (!messages.latest) return;\n  setMessageList((prev) => [...prev, messages.latest!]);\n}, [messages.latest]);\n\nuseEffect(() => {\n  if (!typing.latest) return;\n  setTypingUsers((prev) => {\n    const next = new Set(prev);\n    if (typing.latest!.active) next.add(typing.latest!.sender);\n    else next.delete(typing.latest!.sender);\n    return next;\n  });\n}, [typing.latest]);\n```\n\nDo NOT treat all events the same. Do NOT skip the local-state sync \u2014 `useStream` alone won't trigger DOM updates of your derived view.",
+    promptText: "## Realtime: mixed\nMultiple stream channels with DIFFERENT semantics. Each `streamKinds` entry in the contract maps to one of: merge, append, status, presence. Subscribe + sync to local state PER CHANNEL \u2014 subscribing alone never re-renders the DOM.\n\nExample (chat-interface \u2014 message=append, typing=presence):\n\n```tsx\nconst messages = useStream<MessageT>('message');\nconst typing = useStream<TypingT>('typing');\nconst [messageList, setMessageList] = useState(props.messages);\nconst [typingUsers, setTypingUsers] = useState<Set<string>>(new Set());\n\nuseEffect(() => setMessageList(props.messages), [props.messages]); // re-seed on ggui_amend repaint\n\nuseEffect(() => {\n  if (!messages.latest) return;\n  setMessageList((prev) => [...prev, messages.latest!]);\n}, [messages.latest]);\n\nuseEffect(() => {\n  if (!typing.latest) return;\n  setTypingUsers((prev) => {\n    const next = new Set(prev);\n    if (typing.latest!.active) next.add(typing.latest!.sender);\n    else next.delete(typing.latest!.sender);\n    return next;\n  });\n}, [typing.latest]);\n```\n\nDo NOT treat all events the same. Do NOT skip the local-state sync \u2014 `useStream` alone won't trigger DOM updates of your derived view.",
     boilerplateMarker: [
       "",
       "  // \u2500\u2500 Mixed stream handlers \u2500\u2500",
@@ -13628,13 +12584,14 @@ function generateBoilerplate(_userPrompt, contract, shellType, screen, composedS
   const propsFields = [];
   const propsProperties = contract?.propsSpec?.properties ?? {};
   for (const [key, entry] of Object.entries(propsProperties)) {
-    const required = entry.required !== false;
+    const required = entry.required === true;
     const nullable = entry.schema.nullable === true;
     const tsType = jsonSchemaTypeToTs(entry.schema);
     const fullType = nullable ? `${tsType} | null` : tsType;
     const parts = [];
     if (entry.description) parts.push(entry.description);
     if (entry.default !== void 0) parts.push(`(default: ${JSON.stringify(entry.default)})`);
+    if (!required) parts.push("(optional \u2014 the agent may omit it; guard or fall back)");
     const desc = parts.length > 0 ? ` // ${parts.join(" ")}` : "";
     propsFields.push(`  ${key}${required ? "" : "?"}: ${fullType};${desc}`);
   }
@@ -14191,13 +13148,15 @@ A \`DataContract\` declares everything a GguiSession exchanges with the outside
 
 ## Defensive coding for absent / late-arriving data
 
-Props arrive via \`ggui_update\` and may be partial on first render. Stream channels start empty and fill over time. Context slots start at their declared default (often \`null\`). **Never assume a field exists before you read it.**
+Props arrive at mount and may be partial on first render; later prop changes reach the SAME mounted component via \`ggui_amend\` (in-place repaint) on the live channel. Stream channels start empty and fill over time. Context slots start at their declared default (often \`null\`). **Never assume a field exists before you read it.**
 
+- **Optional contract props**: a \`Props\` field marked \`?\` in the boilerplate may be omitted by the agent ENTIRELY \u2014 the wire gate only enforces \`required: true\` entries, and the harness verifies your component with those props stripped. Guard them (\`?? default\`, \`?.\`, or an empty-state branch) from the FIRST render.
 - **Array iteration**: always default to \`[]\` before \`.map\`/\`.filter\`/\`.length\`. Use \`(props.items ?? []).map(...)\` not \`props.items.map(...)\`. Same for stream.all, stream.latest, etc.
 - **Object access**: optional-chain through nested fields. \`props.user?.name ?? 'Anonymous'\` not \`props.user.name\`.
 - **Number ops**: default before arithmetic. \`(props.count ?? 0) + 1\` not \`props.count + 1\`.
 - **Stream latest**: \`useStream\` returns \`{latest: T | null, all: T[], isComplete: boolean}\`. The default \`all\` is \`[]\` so it's safe to map; \`latest\` is null until the first frame arrives \u2014 guard before reading \`.foo\`.
 - **Stream reconciliation**: when a stream event carries an \`action\` discriminant (e.g. \`create | move | edit | delete\`), the channel is a CRUD feed \u2014 your handler MUST branch on EVERY value: append on \`create\`, drop on \`delete\`, replace-by-id on \`move\` / \`edit\`. Merging only the "edit" case silently loses created and deleted items. Reconcile into the SAME state that seeds from \`props\` (e.g. \`useState(() => props.tasks ?? [])\`) so the seed data and the live feed render as one list \u2014 and handle an event whose id is not yet present (a \`create\` for an unknown item) by inserting it, not ignoring it.
+- **Props re-sync on repaint**: props the agent owns are the source of truth for display \u2014 prefer rendering DIRECTLY from \`props\` (controlled, no local copy). When local optimistic state genuinely needs a prop seed (a click bumps a count before the agent confirms), it MUST re-sync on prop change \u2014 \`useEffect(() => setCount(props.count ?? 0), [props.count])\` \u2014 or a \`ggui_amend\` repaint applies the new props while the display keeps the stale local value. BAD: \`const [count, setCount] = useState(props.count ?? 0)\` alone. GOOD: the same seed + the one-line re-sync effect.
 - **Loading state**: while data is still absent, render \`<Skeleton>\` placeholders \u2014 never a blank screen. \`<Skeleton variant="text" />\` for a text line, \`variant="circle"\` for an avatar slot, default \`rect\` for a block.
 - **Empty state**: when a list or results array is empty, render \`<EmptyState title="\u2026" description="\u2026" />\` \u2014 a region that renders nothing when empty looks broken to the user.
 
@@ -14325,7 +13284,7 @@ Every value change is mirrored to the host LLM's context automatically (debounce
 
 **When NOT to use it.** Local UI state the contract did NOT declare \u2014 \`isDropdownOpen\`, hover flags, animation phase, ephemeral toggles. For those, use a plain \`useState\` directly. The runtime ignores undeclared state.
 
-**\`contextSpec\` direction is one-way: client \u2192 agent.** The agent uses \`propsSpec\` (via \`ggui_update\`) and \`streamSpec\` (via the live channel) to push state TO the client. Don't try to write to the agent via \`contextSpec\` \u2014 there is no return path.
+**\`contextSpec\` direction is one-way: client \u2192 agent.** The agent uses \`propsSpec\` (via \`ggui_amend\` for in-place repaints of this mount, or \`ggui_update\` when it mints a new history card) and \`streamSpec\` (via the live channel) to push state TO the client. Don't try to write to the agent via \`contextSpec\` \u2014 there is no return path.
 
 **Schema mismatches drop silently.** If you set a value that doesn't match the slot's schema (e.g. a string into a \`{type: 'number'}\` slot), the runtime logs a dev \`console.warn\` and skips the post. Make sure your setter calls produce values that match the declared shape.
 
@@ -15432,6 +14391,31 @@ function runNoPhantomUseState(input) {
   }
   return issues;
 }
+function runPropSeedNoResync(input) {
+  if (input.compiledCode === null) return [];
+  const src = input.sourceCode;
+  const issues = [];
+  const re = /const\s*\[\s*(\w+)\s*,\s*(\w+)\s*\]\s*=\s*useState(?:<[^>]*>)?\s*\(\s*props\??\.(\w+)/g;
+  for (const m of src.matchAll(re)) {
+    const [full, stateVar, setter, propName] = m;
+    const idx = m.index ?? 0;
+    const after = src.slice(idx + full.length);
+    if (!new RegExp(`\\b${setter}\\s*\\(`).test(after)) continue;
+    const resync = new RegExp(
+      `\\[[^\\[\\]]*props\\??\\.${propName}\\b[^\\[\\]]*\\]`
+    );
+    if (resync.test(src)) continue;
+    issues.push(
+      mkIssue(
+        "universal.prop_seed_no_resync",
+        `useState(props.${propName}) seeds "${stateVar}" and mutates it, but no effect depends on [props.${propName}] \u2014 a ggui_amend repaint pushes new props that never reach this display (#480).`,
+        `Add \`useEffect(() => ${setter}(props.${propName}), [props.${propName}]);\` so agent repaints re-seed the state, or derive the display directly from props.${propName}.`,
+        "warn"
+      )
+    );
+  }
+  return issues;
+}
 var UNIVERSAL_CHECKS = [
   {
     id: "universal.prop_coverage",
@@ -15450,6 +14434,12 @@ var UNIVERSAL_CHECKS = [
     axis: "render",
     values: ALL_RENDER_VALUES,
     run: runNoPhantomUseState
+  },
+  {
+    id: "universal.prop_seed_no_resync",
+    axis: "render",
+    values: ALL_RENDER_VALUES,
+    run: runPropSeedNoResync
   }
 ];
 
@@ -15469,7 +14459,7 @@ function runStateSeededFromProps(input) {
       mkIssue(
         "state.merge.seeded_from_props",
         `Entity collection "${e.name}" is not seeded from props \u2014 no useState initializer reads props.${e.name}.`,
-        `Add \`const [${e.name}, set${cap(e.name)}] = useState(props.${e.name});\` so stream/action updates can merge into live state.`
+        `Add \`const [${e.name}, set${cap(e.name)}] = useState(props.${e.name});\` paired with \`useEffect(() => set${cap(e.name)}(props.${e.name}), [props.${e.name}]);\` so stream/action updates merge into live state AND agent repaints (ggui_amend) re-seed it (#480).`
       )
     );
   }
@@ -15573,6 +14563,106 @@ var STATE_MERGE_CHECKS = [
   }
 ];
 
+// src/evaluation/axis-checks/checks/state-ui-affordance.ts
+var STATE_ARIA_OR_ROLE = /aria-(checked|pressed|selected|expanded|current)\s*=|role\s*=/;
+var STATE_PRIMITIVE_IN_SUBTREE = /<(Checkbox|Toggle|Tabs|Accordion)[\s/>]/;
+var SEMANTIC_PRIMITIVES = /* @__PURE__ */ new Set(["Button", "Checkbox", "Toggle", "Link", "MenuItem"]);
+function collectSetters(src) {
+  const setters = /* @__PURE__ */ new Set();
+  for (const m of src.matchAll(/const\s*\[\s*\w+\s*,\s*(set\w+)\s*\]\s*=\s*useState/g)) {
+    setters.add(m[1]);
+  }
+  return setters;
+}
+function collectHandlers(src, setters) {
+  const handlers = /* @__PURE__ */ new Set();
+  for (const m of src.matchAll(/const\s+(\w+)\s*=\s*(?:\([^)]*\)|\w+)\s*=>\s*\{?/g)) {
+    const body = src.slice(m.index + m[0].length, m.index + m[0].length + 400);
+    for (const s of setters) {
+      if (body.includes(s)) {
+        handlers.add(m[1]);
+        break;
+      }
+    }
+  }
+  return handlers;
+}
+function attrBlock(src, start) {
+  let depth = 0;
+  for (let i = start; i < src.length; i++) {
+    const c = src[i];
+    if (c === "{") depth++;
+    else if (c === "}") depth--;
+    else if (c === ">" && depth === 0) return { block: src.slice(start, i), end: i };
+  }
+  return { block: src.slice(start, start + 900), end: start + 900 };
+}
+function onClickValue(block) {
+  const m = block.match(/onClick\s*=\s*\{/);
+  if (!m || m.index === void 0) return null;
+  const open = m.index + m[0].length - 1;
+  let depth = 0;
+  for (let i = open; i < block.length; i++) {
+    if (block[i] === "{") depth++;
+    else if (block[i] === "}") {
+      depth--;
+      if (depth === 0) return block.slice(open + 1, i);
+    }
+  }
+  return block.slice(open + 1);
+}
+function subtree(src, pos, tag) {
+  const close = src.indexOf(`</${tag}>`, pos);
+  return src.slice(pos, close === -1 ? pos + 700 : close);
+}
+function runStateAriaPresent(input) {
+  if (input.compiledCode === null) return [];
+  const src = input.sourceCode;
+  const setters = collectSetters(src);
+  const handlers = collectHandlers(src, setters);
+  const issues = [];
+  const flaggedLines = /* @__PURE__ */ new Set();
+  const localComponents = /* @__PURE__ */ new Set();
+  for (const m of src.matchAll(/(?:function\s+([A-Z]\w*)\s*\(|const\s+([A-Z]\w*)\s*=)/g)) {
+    localComponents.add(m[1] ?? m[2]);
+  }
+  for (const m of src.matchAll(/<([A-Za-z][A-Za-z0-9]*)\b/g)) {
+    const tag = m[1];
+    if (m.index === void 0) continue;
+    if (localComponents.has(tag)) continue;
+    const { block, end } = attrBlock(src, m.index + m[0].length);
+    const clickValue = onClickValue(block);
+    if (clickValue === null) continue;
+    const mutatesAffordance = [...setters].some((s) => clickValue.includes(s)) || [...handlers].some((h) => new RegExp(`\\b${h}\\b`).test(clickValue)) || // Extracted-subcomponent shape: the toggle handler arrives as an
+    // `on[A-Z]…` callback prop and is invoked from onClick — inside a
+    // ui-affordance component that IS the affordance mutation.
+    /\bon[A-Z]\w*\b/.test(clickValue);
+    if (!mutatesAffordance) continue;
+    if (SEMANTIC_PRIMITIVES.has(tag)) continue;
+    if (STATE_ARIA_OR_ROLE.test(block)) continue;
+    if (STATE_PRIMITIVE_IN_SUBTREE.test(subtree(src, end, tag))) continue;
+    const line = src.slice(0, m.index).split("\n").length;
+    if (flaggedLines.has(line)) continue;
+    flaggedLines.add(line);
+    issues.push(
+      mkIssue(
+        "state.ui_affordance.state_aria_present",
+        `Line ${line}: <${tag}> toggles the UI affordance from its onClick but exposes no state ARIA \u2014 its checked/selected/expanded state is invisible to assistive technology (styling is the only carrier).`,
+        `Add the matching state attribute to the SAME element that carries the onClick: \`role="checkbox"\` + \`aria-checked={\u2026}\` for a toggle row, \`aria-pressed\` for a toggle button, \`aria-selected\` for a selection, \`aria-expanded\` for an open/close affordance \u2014 or replace the hand-rolled control with the state-carrying primitive (Checkbox / Toggle / Tabs / Accordion). \`as={Clickable}\` adds button + keyboard semantics but NOT state.`
+      )
+    );
+  }
+  return issues;
+}
+var STATE_UI_AFFORDANCE_CHECKS = [
+  {
+    id: "state.ui_affordance.state_aria_present",
+    axis: "state",
+    values: ["ui-affordance"],
+    run: runStateAriaPresent
+  }
+];
+
 // src/evaluation/axis-checks/checks/realtime.ts
 var REALTIME_ACTIVE = ["merge", "append", "status", "presence", "mixed"];
 function runStreamHandlerPerEvent(input) {
@@ -16262,6 +15352,7 @@ var EXTRA_CHECKS = [
 var REGISTRY = [
   ...UNIVERSAL_CHECKS,
   ...STATE_MERGE_CHECKS,
+  ...STATE_UI_AFFORDANCE_CHECKS,
   ...REALTIME_CHECKS,
   ...WRITES_CHECKS,
   ...STATE_PAYLOAD_CHECKS,
@@ -16432,8 +15523,8 @@ ${cjsResult.code}
 // src/harness/check/runtime-render/load-component.ts
 async function loadComponent(input) {
   const { sourceCode, moduleResolutions = {} } = input;
-  const { createRequire: createRequire3 } = await import('module');
-  const require_ = createRequire3(import.meta.url);
+  const { createRequire: createRequire4 } = await import('module');
+  const require_ = createRequire4(import.meta.url);
   const sandboxRequire = (id) => {
     if (id in moduleResolutions) return moduleResolutions[id];
     if (id === "react/jsx-runtime" || id === "react/jsx-dev-runtime") {
@@ -16689,6 +15780,47 @@ function wrapDetection(kind, jsx, native, custom) {
 function dedupe(arr) {
   return Array.from(new Set(arr));
 }
+var installed = false;
+function installProductionActShim() {
+  if (installed) return;
+  installed = true;
+  const require_ = createRequire(import.meta.url);
+  let reactCjs;
+  try {
+    reactCjs = require_("react");
+  } catch {
+    return;
+  }
+  if (typeof reactCjs.act === "function") {
+    return;
+  }
+  try {
+    const testUtils = require_("react-dom/test-utils");
+    const reactDom = require_("react-dom");
+    testUtils.act = createFlushSyncAct(reactDom.flushSync);
+  } catch {
+  }
+}
+function createFlushSyncAct(flushSync) {
+  return (callback) => {
+    let callbackResult;
+    flushSync(() => {
+      callbackResult = callback();
+    });
+    if (isThenable(callbackResult)) {
+      const pending = callbackResult;
+      return new Promise((resolve3, reject) => {
+        pending.then(() => resolve3(), reject);
+      });
+    }
+    return new Promise((resolve3) => {
+      queueMicrotask(resolve3);
+    });
+  };
+}
+function isThenable(value) {
+  return typeof value === "object" && value !== null && typeof value.then === "function";
+}
 
 // src/internal/open-record.ts
 function openRecord(o) {
@@ -16806,6 +15938,7 @@ async function runRenderCheck(input) {
     const probe = createProbe();
     const wireConfig = createProbeWireConfig(probe);
     uninstallSpy = probe.installPostMessageSpy();
+    installProductionActShim();
     const { render, cleanup } = await import('@testing-library/react');
     const userEventModule = await import('@testing-library/user-event');
     const userEvent = userEventModule.default ?? userEventModule;
@@ -16961,6 +16094,50 @@ async function runRenderCheck(input) {
           if (issue) issues.push(issue);
         }
       }
+      const declaredProps = input.contract?.propsSpec?.properties;
+      if (declaredProps) {
+        const optionalFilled = Object.entries(declaredProps).filter(
+          ([name, entry]) => entry.required !== true && input.mockupProps[name] !== void 0
+        ).map(([name]) => name);
+        if (optionalFilled.length > 0) {
+          const requiredOnlyProps = { ...input.mockupProps };
+          for (const name of optionalFilled) delete requiredOnlyProps[name];
+          const omitBoundaryRef = {};
+          class OmitErrorBoundary extends React.Component {
+            state = { caught: false };
+            static getDerivedStateFromError() {
+              return { caught: true };
+            }
+            componentDidCatch(error) {
+              omitBoundaryRef.error ??= error;
+            }
+            render() {
+              if (this.state.caught) return null;
+              return this.props.children;
+            }
+          }
+          try {
+            render(
+              React.createElement(GguiWireProvider, {
+                config: wireConfig,
+                children: React.createElement(OmitErrorBoundary, {
+                  children: React.createElement(Component, requiredOnlyProps)
+                })
+              })
+            );
+          } catch (e) {
+            omitBoundaryRef.error ??= e instanceof Error ? e : new Error(String(e));
+          }
+          if (omitBoundaryRef.error) {
+            issues.push({
+              check: "optional-props-omitted",
+              outcome: "failed",
+              subject: optionalFilled.join(", "),
+              reason: `Render crashed when the optional prop(s) ${optionalFilled.map((n) => `'${n}'`).join(", ")} were omitted: ${omitBoundaryRef.error.message}. The contract marks them optional (no \`required: true\`), so a legitimate render may leave them out.`
+            });
+          }
+        }
+      }
     } finally {
       cleanup();
     }
@@ -17128,8 +16305,8 @@ async function setupHappyDom() {
     };
   }
   const { Window } = await import('happy-dom');
-  const window2 = new Window({ url: "https://render-check.local" });
-  const windowAny = openRecord(window2);
+  const window = new Window({ url: "https://render-check.local" });
+  const windowAny = openRecord(window);
   const keys = [
     "window",
     "document",
@@ -17532,6 +16709,15 @@ function synthesizeFromSchema2(schema, hint, warnings, depth) {
   if (schema.anyOf && schema.anyOf.length > 0) {
     return synthesizeFromSchema2(schema.anyOf[0], hint, warnings, depth + 1);
   }
+  if (Array.isArray(schema.type)) {
+    const primary = schema.type.find((t) => t !== "null") ?? "null";
+    return synthesizeFromSchema2(
+      { ...schema, type: primary },
+      hint,
+      warnings,
+      depth + 1
+    );
+  }
   switch (schema.type) {
     case "string": {
       switch (schema.format) {
@@ -17702,6 +16888,16 @@ function toEvalIssue(issue) {
         description: `Component crashed at runtime: ${issue.reason}`,
         fix: classifyRenderCrashFix(issue.reason)
       };
+    case "optional-props-omitted":
+      return {
+        tier: 0,
+        result,
+        category: "crash",
+        subcategory,
+        severity: "critical",
+        description: `Component crashed when optional props were omitted: ${issue.reason}`,
+        fix: `Guard every optional prop before member access (props.${subject.split(",")[0]?.trim() ?? "x"}?.map(...), a default via destructuring, or an early empty-state return). Optional props (no \`required: true\` in the contract) may be absent at runtime even though the harness fills them.`
+      };
     case "action-wiring": {
       const fix = issue.outcome === "unverified" ? `Source shows the action callback flowing into a non-native or custom-component prop. If wiring is intentional (e.g., Dropdown.onChange, drag-drop), this warn is informational \u2014 manual/browser verification is required to confirm. Otherwise wire to a native onClick={() => ${subject}(payload)} on <button> or design-system <Button>.` : `Wire ${subject}() to a native event prop. Common fix: <Button onClick={() => ${subject}(payload)}>Label</Button>. Source-AST analysis didn't find this wiring in your JSX.`;
       return {
@@ -17748,6 +16944,7 @@ async function warmupRuntimeRenderProbe() {
       missing += 1;
     }
   };
+  installProductionActShim();
   await Promise.all([
     tryLoad("happy-dom"),
     tryLoad("@testing-library/react"),
@@ -18824,6 +18021,14 @@ function mapProviderForEvaluator(provider) {
 
 // src/harness/coding/run-eval-round.ts
 var MAX_FEEDBACK_ISSUES = 3;
+function selectActionableFeedback(issues) {
+  const pool = issues.filter((i) => i.result === "fail" || i.result === "warn");
+  const reserved = pool.find((i) => i.tier === 0 && i.result === "fail");
+  return [
+    ...reserved ? [reserved] : [],
+    ...pool.filter((i) => i !== reserved).sort((a, b) => (a.result === "fail" ? 0 : 1) - (b.result === "fail" ? 0 : 1))
+  ].slice(0, MAX_FEEDBACK_ISSUES);
+}
 function fingerprintFail(issue) {
   const cat = issue.category ?? "";
   const sub = issue.subcategory ?? "";
@@ -18992,7 +18197,20 @@ async function runEvalRound(ctx, input) {
         },
         {
           provider: mapProviderForEvaluator(evaluationAgent.provider),
-          model: evaluationAgent.model
+          model: evaluationAgent.model,
+          // #484 — thread the coding-agent's routing override
+          // through to the evaluator so its LLM call never falls
+          // back to `process.env` either (the eval calls run
+          // inside the same concurrent generation, so the race is
+          // real here too, not just on the coding turn).
+          routeOverride: evaluationAgent.routeOverride,
+          // #489 — thread the same provider-429-retry observer.
+          // Without this, a rate-limited retry inside the
+          // evaluation agent's apiCall() happens (the base-class
+          // retry loop is unconditional) but never reaches the
+          // caller, silently missing the host application's
+          // structured log.
+          onRetry: evaluationAgent.onRetry
         },
         preWarmedContext
       ) : null,
@@ -19003,7 +18221,15 @@ async function runEvalRound(ctx, input) {
           model: visualEvalAgent.model,
           passThreshold: visualThreshold,
           sampleProps: visualEvaluation?.sampleProps,
-          viewport: visualEvaluation?.viewport
+          viewport: visualEvaluation?.viewport,
+          // #484/#489 — same threading as the LLM-eval leg above:
+          // the visual eval's multimodal call runs inside the same
+          // concurrent generation, so it needs the same routing
+          // override (never fall back to `process.env`) and the
+          // same provider-429-retry observer (retries reach the
+          // host application's structured log).
+          routeOverride: visualEvalAgent.routeOverride,
+          onRetry: visualEvalAgent.onRetry
         }
       ) : null
     ]);
@@ -19222,7 +18448,7 @@ async function runEvalRound(ctx, input) {
         lastDiffFailed: false
       };
     }
-    const allActionable = evalResult.issues.filter((i) => i.result === "fail" || i.result === "warn").sort((a, b) => (a.result === "fail" ? 0 : 1) - (b.result === "fail" ? 0 : 1)).slice(0, MAX_FEEDBACK_ISSUES);
+    const allActionable = selectActionableFeedback(evalResult.issues);
     const issueLines = allActionable.map((issue) => {
       const tag = issue.result === "fail" ? "FAIL" : "WARN";
       return `[${tag}] ${issue.category}${issue.subcategory ? "/" + issue.subcategory : ""}: ${issue.description}
@@ -19237,7 +18463,16 @@ async function runEvalRound(ctx, input) {
       evalResult,
       evalRoundsUsed,
       prevModeSubcats: updatedPrevModeSubcats,
-      prevFailFingerprints: currFailFingerprints,
+      // DELIVERED fails only (Exp 54 P1 addendum, proposal 2): the
+      // stuck detector's premise is "the LLM saw these and did not
+      // resolve them" — recording fails that the MAX_FEEDBACK_ISSUES
+      // cap cut from the feedback turns truncation into a premature
+      // stuck-exit (the model never saw the issue it is blamed for
+      // not fixing). An undelivered fail recurring next round now
+      // reads as NEW, gets delivered, and earns its fix round.
+      prevFailFingerprints: new Set(
+        allActionable.filter((i) => i.result === "fail").map(fingerprintFail)
+      ),
       preWarmedContext,
       evalTokens,
       evalLlmMs,
@@ -19640,7 +18875,7 @@ async function initSession(input) {
   await workspace.stage();
   await workspace.commit("scaffold: boilerplate");
   const systemPrompt = input.systemPromptOverride ?? harness.how.systemPrompt;
-  const codingAgent = createAgent(agents.coding.provider);
+  const codingAgent = createAgent(agents.coding);
   await codingAgent.warmCache(
     agents.coding.model,
     systemPrompt,
@@ -19729,8 +18964,18 @@ async function dispatchGeneration(params) {
   }
   const routerProvider = mapProviderForLLMRouter(params.provider);
   const resolvedModel = params.models?.coding ?? params.models?.default ?? params.model;
-  const codingAgent = { provider: routerProvider, model: resolvedModel };
-  const evaluationAgent = params.models?.evaluation ? { provider: routerProvider, model: params.models.evaluation } : void 0;
+  const codingAgent = {
+    provider: routerProvider,
+    model: resolvedModel,
+    routeOverride: params.routeOverride,
+    onRetry: params.onRetry
+  };
+  const evaluationAgent = params.models?.evaluation ? {
+    provider: routerProvider,
+    model: params.models.evaluation,
+    routeOverride: params.routeOverride,
+    onRetry: params.onRetry
+  } : void 0;
   const effectiveContract = params.contract;
   const sessionParams = {
     userPrompt: params.originalPrompt ?? params.userPrompt,
@@ -20090,11 +19335,15 @@ ${JSON.stringify(clientCapabilities, null, 2)}
   const uiRequirements = [];
   if (contract.propsSpec?.properties) {
     for (const [name, entry] of Object.entries(contract.propsSpec.properties)) {
-      const required = entry.required;
-      if (required !== false) {
+      const required = entry.required === true;
+      if (required) {
         uiRequirements.push(
           `- **Required prop \`${name}\`** must appear somewhere in rendered DOM (display the value, or use it to drive a label/aria/key).`
         );
+      } else {
+        uiRequirements.push(
+          `- **Optional prop \`${name}\`** may be ABSENT at runtime \u2014 the component must render without it (guard the access or apply its default) and must display it when it IS provided.`
+        );
       }
     }
   }
@@ -20177,7 +19426,9 @@ function createUiGenerator(options = {}) {
     maxAttempts,
     maxEvalRounds,
     qualityConfig,
-    gadgetCatalog
+    gadgetCatalog,
+    disableEnvMutation = false,
+    onRetry
   } = options;
   const identity = resolveIdentity(options);
   return {
@@ -20206,16 +19457,22 @@ function createUiGenerator(options = {}) {
         });
       }
       const envBackup = {};
-      for (const k of Object.keys(route.env)) envBackup[k] = process.env[k];
-      const baseEnvForApply = {};
-      for (const [k, v] of Object.entries(process.env)) {
-        if (v !== void 0) baseEnvForApply[k] = v;
-      }
-      const routedEnv = applyRouteToEnv(baseEnvForApply, route);
-      for (const [k, v] of Object.entries(routedEnv)) process.env[k] = v;
-      for (const [k, v] of Object.entries(route.env)) {
-        if (v === void 0) delete process.env[k];
+      if (!disableEnvMutation) {
+        for (const k of Object.keys(route.env)) envBackup[k] = process.env[k];
+        const baseEnvForApply = {};
+        for (const [k, v] of Object.entries(process.env)) {
+          if (v !== void 0) baseEnvForApply[k] = v;
+        }
+        const routedEnv = applyRouteToEnv(baseEnvForApply, route);
+        for (const [k, v] of Object.entries(routedEnv)) process.env[k] = v;
+        for (const [k, v] of Object.entries(route.env)) {
+          if (v === void 0) delete process.env[k];
+        }
       }
+      const routeOverride = disableEnvMutation ? {
+        apiKey: route.env["ANTHROPIC_API_KEY"] ?? route.env["OPENAI_API_KEY"] ?? route.env["GEMINI_API_KEY"] ?? route.env["OPENROUTER_API_KEY"],
+        useBedrock: route.env["CLAUDE_CODE_USE_BEDROCK"] === "1"
+      } : void 0;
       try {
         const tools = createGeneratorTools({
           ...input.contract ? { contract: input.contract } : {}
@@ -20248,7 +19505,9 @@ function createUiGenerator(options = {}) {
           // `Type:` lines and the coding-agent typecheck overlay via
           // `dispatchGeneration`.
           ...input.gadgetTypes !== void 0 ? { gadgetTypes: input.gadgetTypes } : {},
-          enableRuntimeRender
+          enableRuntimeRender,
+          ...routeOverride !== void 0 ? { routeOverride } : {},
+          ...onRetry !== void 0 ? { onRetry } : {}
         });
         const metadata = {
           provider: input.llm.provider,