@ggui-ai/ui-gen 0.21.0 → 0.22.0

package/dist/advanced/index.js

@@ -4,10 +4,10 @@ import { build } from 'esbuild';
 import Anthropic from '@anthropic-ai/sdk';
 import { getCssTokens, fillFitRule, FORBIDDEN_IMPORT_SPECIFIERS } from '@ggui-ai/design/rendering';
 import { classifyUi, MODEL_REGISTRY, DANGEROUS_PATTERNS as DANGEROUS_PATTERNS$1, listContractGadgets, HOOK_NAME_RE, modelRefOfRoute, isGeneratorId, APP_GENERATION_PROFILE_BOUNDS, STDLIB_GADGETS_PACKAGE, resolveAppGadgets, anthropicRejectsForcedToolChoice, normalizeAnthropicModelId, anthropicRejectsSamplingParams, isRecord } from '@ggui-ai/protocol';
-import fs, { existsSync, mkdirSync, writeFileSync, unlinkSync, readFileSync, readdirSync, statSync } from 'fs';
+import fs, { existsSync, mkdtempSync, writeFileSync, rmSync, readFileSync, readdirSync, statSync } from 'fs';
 import { contentHash } from '@ggui-ai/protocol/content-hash';
 import ts4 from 'typescript';
-import path, { dirname, resolve, relative } from 'path';
+import path, { dirname, resolve, relative, join } from 'path';
 import { createRequire } from 'module';
 import { Linter } from 'eslint';
 import { consumedTokenManifest } from '@ggui-ai/design/themes';
@@ -539,18 +539,17 @@ var init_tool_bridge2 = __esm({
 });
 
 // src/adapters/claude/claude-code-login.ts
-function stripProviderKeyEnv(env) {
+function loginChildEnv(env) {
   const out = {};
-  const drop = new Set(PROVIDER_KEY_ENV_NAMES);
   for (const [k, v] of Object.entries(env)) {
-    if (v !== void 0 && !drop.has(k)) out[k] = v;
+    if (v !== void 0 && (LOGIN_CHILD_ENV.has(k) || k.startsWith("LC_"))) out[k] = v;
   }
   return out;
 }
 function claudeCodeLoginQueryOptions() {
   return { tools: [], settingSources: [] };
 }
-var CLAUDE_CODE_LOGIN_CREDENTIAL, PROVIDER_KEY_ENV_NAMES;
+var CLAUDE_CODE_LOGIN_CREDENTIAL, PROVIDER_KEY_ENV_NAMES, LOGIN_CHILD_ENV_NAMES, LOGIN_CHILD_ENV;
 var init_claude_code_login = __esm({
   "src/adapters/claude/claude-code-login.ts"() {
     CLAUDE_CODE_LOGIN_CREDENTIAL = "claude-code-login";
@@ -560,6 +559,38 @@ var init_claude_code_login = __esm({
       "ANTHROPIC_AUTH_TOKEN",
       "ANTHROPIC_BASE_URL"
     ];
+    LOGIN_CHILD_ENV_NAMES = [
+      "PATH",
+      "HOME",
+      "USER",
+      "LOGNAME",
+      "SHELL",
+      "TMPDIR",
+      "TMP",
+      "TEMP",
+      "TERM",
+      "TZ",
+      "LANG",
+      "CLAUDE_CONFIG_DIR",
+      "CLAUDE_CODE_OAUTH_TOKEN",
+      "XDG_CONFIG_HOME",
+      "XDG_DATA_HOME",
+      "XDG_CACHE_HOME",
+      "XDG_STATE_HOME",
+      "XDG_RUNTIME_DIR",
+      "HTTPS_PROXY",
+      "https_proxy",
+      "HTTP_PROXY",
+      "http_proxy",
+      "NO_PROXY",
+      "no_proxy",
+      "ALL_PROXY",
+      "all_proxy",
+      "NODE_EXTRA_CA_CERTS",
+      "SSL_CERT_FILE",
+      "SSL_CERT_DIR"
+    ];
+    LOGIN_CHILD_ENV = new Set(LOGIN_CHILD_ENV_NAMES);
   }
 });
 
@@ -608,7 +639,7 @@ var init_sdk = __esm({
         const cfg = this.sdkConfig;
         const { query } = await import('@anthropic-ai/claude-agent-sdk');
         const login = cfg.claudeCodeLogin === true;
-        const env = login ? stripProviderKeyEnv(buildEnv(cfg.env)) : buildEnv(cfg.env);
+        const env = login ? loginChildEnv(buildEnv(cfg.env)) : buildEnv(cfg.env);
         const artifacts = createArtifacts();
         const onProgress = cfg.onProgress;
         let mcpServers = cfg.mcpServers;
@@ -4504,7 +4535,7 @@ function buildLoginQueryOptions(params) {
     systemPrompt: params.systemPrompt,
     maxTurns: 1,
     thinking: { type: "disabled" },
-    env: stripProviderKeyEnv(params.env ?? process.env),
+    env: loginChildEnv(params.env ?? process.env),
     ...claudeCodeLoginQueryOptions(),
     ...params.tools !== void 0 ? {
       mcpServers: { [MCP_SERVER_NAME]: params.tools.server },
@@ -7209,6 +7240,14 @@ function getDefaultEvalModel(provider) {
       return "claude-haiku-4-5-20251001";
   }
 }
+function callTokens(response) {
+  return {
+    in: response.inputTokens,
+    out: response.outputTokens,
+    ...response.cacheReadTokens !== void 0 ? { cacheRead: response.cacheReadTokens } : {},
+    ...response.cacheCreationTokens !== void 0 ? { cacheCreation: response.cacheCreationTokens } : {}
+  };
+}
 async function evalCriterion(criterion, tier, motherPrompt, numberedSource, agent, model, designMode) {
   const start = Date.now();
   const tool = tier === 1 ? makeTier1Tool(criterion) : makeTier2Tool(criterion);
@@ -7232,7 +7271,7 @@ async function evalCriterion(criterion, tier, motherPrompt, numberedSource, agen
         pass: true,
         coverage: "skipped",
         skipReason: "no tool call returned",
-        tokens: { in: response.inputTokens, out: response.outputTokens },
+        tokens: callTokens(response),
         durationMs
       };
     }
@@ -7285,7 +7324,7 @@ async function evalCriterion(criterion, tier, motherPrompt, numberedSource, agen
       issues,
       pass,
       coverage: "ran",
-      tokens: { in: response.inputTokens, out: response.outputTokens },
+      tokens: callTokens(response),
       durationMs
     };
   } catch (e) {
@@ -7368,7 +7407,8 @@ async function runLLMEvaluation(context, config, preWarmedContext) {
   const passCategories = [];
   let totalIn = 0;
   let totalOut = 0;
-  let cachedTokensEstimate = 0;
+  let cacheRead;
+  let cacheCreation;
   for (const r of results) {
     allIssues.push(...r.issues);
     if (r.pass) {
@@ -7376,10 +7416,8 @@ async function runLLMEvaluation(context, config, preWarmedContext) {
     }
     totalIn += r.tokens.in;
     totalOut += r.tokens.out;
-  }
-  const firstResult = results[0];
-  if (firstResult && firstResult.tokens.in > 0) {
-    cachedTokensEstimate = firstResult.tokens.in * (totalCriteriaCount - 1);
+    if (r.tokens.cacheRead !== void 0) cacheRead = (cacheRead ?? 0) + r.tokens.cacheRead;
+    if (r.tokens.cacheCreation !== void 0) cacheCreation = (cacheCreation ?? 0) + r.tokens.cacheCreation;
   }
   const wallMs = Date.now() - evalStart;
   const criteriaCoverage = results.map((r) => ({
@@ -7396,14 +7434,16 @@ async function runLLMEvaluation(context, config, preWarmedContext) {
     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}` + (skippedCount > 0 ? ` skipped=${skippedCount}` : "")
+    `[eval] total: ${(wallMs / 1e3).toFixed(1)}s wall (${totalCriteriaCount} parallel) | in=${totalIn} out=${totalOut} cacheRead=${cacheRead ?? "unreported"} cacheWrite=${cacheCreation ?? "unreported"} | issues=${allIssues.length} pass=${passCategories.length}` + (skippedCount > 0 ? ` skipped=${skippedCount}` : "")
   );
   return {
     issues: allIssues,
     pass: passCategories,
     criteriaCoverage,
     inputTokens: totalIn,
-    outputTokens: totalOut
+    outputTokens: totalOut,
+    ...cacheRead !== void 0 ? { cacheReadTokens: cacheRead } : {},
+    ...cacheCreation !== void 0 ? { cacheCreationTokens: cacheCreation } : {}
   };
 }
 var FREE_STYLING_RULES, CONSTRAINED_STYLING_RULES, CONSTRAINED_VISUAL_REFERENCE, FREE_VISUAL_REFERENCE, CONSTRAINED_RAW_CLICK_TARGET_GAP, FREE_RAW_CLICK_TARGET_GAP, TIER_1_CRITERIA, TIER_2_CRITERIA, TIER_1_CATEGORIES, TIER_2_CATEGORIES, VALID_CATEGORIES;
@@ -7657,8 +7697,7 @@ function resolveDesignPackageDir() {
   }
 }
 async function bundleForRendering(compiledCode, sampleProps, designSrc = resolve(resolveDesignPackageDir(), "src")) {
-  const tmpDir = resolve(tmpdir(), "ggui-visual-eval-" + Date.now());
-  mkdirSync(tmpDir, { recursive: true });
+  const tmpDir = mkdtempSync(resolve(tmpdir(), "ggui-visual-eval-"));
   const componentFile = resolve(tmpDir, "component.tsx");
   const entryFile = resolve(tmpDir, "entry.tsx");
   const designPkgDir = resolve(designSrc, "..");
@@ -7733,14 +7772,7 @@ try {
     });
     return result.outputFiles[0]?.text ?? "";
   } finally {
-    try {
-      unlinkSync(entryFile);
-    } catch {
-    }
-    try {
-      unlinkSync(componentFile);
-    } catch {
-    }
+    rmSync(tmpDir, { recursive: true, force: true });
   }
 }
 function buildRenderHTML(bundledCode, cssTokens, fit) {
@@ -16344,7 +16376,11 @@ async function assembleGenerationResult(input) {
     generationTimeMs: totalMs,
     turnsUsed: telemetry.turnsUsed,
     passesUsed: 1,
-    evalResult: telemetry.evalResult,
+    // ggui#1261 — the contract-feedback round's record rides the result the
+    // generation ends with (whose probe stamp is the post-round verdict).
+    evalResult: telemetry.evalResult !== void 0 && telemetry.contractFeedback !== void 0 ? { ...telemetry.evalResult, contractFeedback: telemetry.contractFeedback } : telemetry.evalResult,
+    // ggui#404 — present only when the same-exchange guard ended the run.
+    ...telemetry.sameExchangeBreak !== void 0 ? { sameExchangeBreak: telemetry.sameExchangeBreak } : {},
     needsBackgroundImprovement,
     selfCheckPassed: telemetry.selfCheckPassed,
     timing,
@@ -17099,7 +17135,8 @@ ${iconNamesCache}`;
         lastDiffFailed: false,
         isEvalFeedback: false,
         iconNamesCache,
-        preWarmedContext
+        preWarmedContext,
+        sameExchangeBreak: { tool: call.name, repeats: iconRepeats }
       };
     }
     return {
@@ -17299,7 +17336,8 @@ Repeated error: ${errText}
       lastDiffFailed: false,
       isEvalFeedback: false,
       iconNamesCache,
-      preWarmedContext
+      preWarmedContext,
+      sameExchangeBreak: { tool: call.name, repeats: sameExchangeRepeats }
     };
   }
   const turnDiffFailed = !!result.error && result.result.includes("DIFF");
@@ -17488,6 +17526,20 @@ function formatRuntimeProbeFeedback(issue) {
   return `[runtime] ${issue.category}${subcat}: ${issue.description}
   Fix: ${issue.fix ?? ""}`;
 }
+var FEEDBACK_PROBE_CHECKS = ["prop-sensitivity"];
+var CONTRACT_FEEDBACK_BONUS = 1;
+function isFeedbackProbeFail(issue) {
+  const sub = issue.subcategory;
+  if (issue.result !== "fail" || typeof sub !== "string") return false;
+  return FEEDBACK_PROBE_CHECKS.some((check) => sub === `runtime:${check}` || sub.startsWith(`runtime:${check}:`));
+}
+function contractFeedbackRecord(fails, sourceBefore) {
+  return { firedOn: fails.flatMap((i) => i.subcategory !== void 0 ? [i.subcategory] : []), sourceBefore };
+}
+function contractFeedbackFails(exitProbe, alreadyFedBack) {
+  if (!exitProbe.fired) return [];
+  return exitProbe.probeIssues.filter((i) => isFeedbackProbeFail(i) && !alreadyFedBack.has(fingerprintFail(i)));
+}
 async function runEvalRound(ctx, input) {
   const {
     workspace,
@@ -17677,7 +17729,9 @@ async function runEvalRound(ctx, input) {
       costTracker.record(evaluationAgent.model, llmResult.inputTokens, llmResult.outputTokens);
       evalTokens = {
         input: llmResult.inputTokens,
-        output: llmResult.outputTokens
+        output: llmResult.outputTokens,
+        ...llmResult.cacheReadTokens !== void 0 ? { cacheRead: llmResult.cacheReadTokens } : {},
+        ...llmResult.cacheCreationTokens !== void 0 ? { cacheCreation: llmResult.cacheCreationTokens } : {}
       };
     }
     const allIssues = [
@@ -17762,6 +17816,34 @@ async function runEvalRound(ctx, input) {
           lastDiffFailed: false
         };
       }
+      const contractFails = contractFeedbackFails(exitProbe, prevFailFingerprints);
+      if (contractFails.length > 0 && evalRoundsUsed < maxEvalRounds + CONTRACT_FEEDBACK_BONUS) {
+        const lines = contractFails.slice(0, MAX_FEEDBACK_ISSUES).map(formatRuntimeProbeFeedback);
+        evalResult = {
+          ...evalResult,
+          issues: [...allIssues, ...exitProbe.probeIssues],
+          pass: allPass,
+          runtimeProbe: exitProbe.meta
+        };
+        console.log(
+          `[simple] eval round ${evalRoundsUsed}: tier-1/2 clean BUT contract probe fail \u2014 granting +1 turn (ggui#1261; ${contractFails.map((i) => i.subcategory).join(", ")})`
+        );
+        return {
+          control: "feedback",
+          evalDone: false,
+          evalResult,
+          evalRoundsUsed,
+          prevModeSubcats: updatedPrevModeSubcats,
+          prevFailFingerprints: /* @__PURE__ */ new Set([...currFailFingerprints, ...contractFails.map(fingerprintFail)]),
+          preWarmedContext,
+          evalTokens,
+          evalLlmMs,
+          lastResultText: lines.join("\n\n"),
+          isEvalFeedback: true,
+          lastDiffFailed: false,
+          contractFeedback: contractFeedbackRecord(contractFails, currentSource)
+        };
+      }
       evalResult = {
         ...evalResult,
         issues: [...allIssues, ...exitProbe.probeIssues],
@@ -17801,6 +17883,28 @@ async function runEvalRound(ctx, input) {
         issues: [...evalResult.issues, ...stuckExitProbe.probeIssues],
         runtimeProbe: stuckExitProbe.meta
       };
+      const stuckContractFails = contractFeedbackFails(stuckExitProbe, prevFailFingerprints);
+      if (stuckContractFails.length > 0 && evalRoundsUsed < maxEvalRounds + CONTRACT_FEEDBACK_BONUS) {
+        const lines = stuckContractFails.slice(0, MAX_FEEDBACK_ISSUES).map(formatRuntimeProbeFeedback);
+        console.log(
+          `[simple] eval round ${evalRoundsUsed}: stuck BUT contract probe fail never delivered \u2014 granting +1 turn (ggui#1261; ${stuckContractFails.map((i) => i.subcategory).join(", ")})`
+        );
+        return {
+          control: "feedback",
+          evalDone: false,
+          evalResult,
+          evalRoundsUsed,
+          prevModeSubcats: updatedPrevModeSubcats,
+          prevFailFingerprints: /* @__PURE__ */ new Set([...currFailFingerprints, ...stuckContractFails.map(fingerprintFail)]),
+          preWarmedContext,
+          evalTokens,
+          evalLlmMs,
+          lastResultText: lines.join("\n\n"),
+          isEvalFeedback: true,
+          lastDiffFailed: false,
+          contractFeedback: contractFeedbackRecord(stuckContractFails, currentSource)
+        };
+      }
       return {
         control: "break",
         evalDone: false,
@@ -17855,6 +17959,33 @@ async function runEvalRound(ctx, input) {
           lastDiffFailed: false
         };
       }
+      const capContractFails = allowRuntimeExtension ? [] : contractFeedbackFails(exitProbe, prevFailFingerprints);
+      if (capContractFails.length > 0 && evalRoundsUsed < maxEvalRounds + CONTRACT_FEEDBACK_BONUS) {
+        const contractLines = capContractFails.slice(0, MAX_FEEDBACK_ISSUES).map(formatRuntimeProbeFeedback);
+        evalResult = {
+          ...evalResult,
+          issues: [...evalResult.issues, ...exitProbe.probeIssues],
+          runtimeProbe: exitProbe.meta
+        };
+        console.log(
+          `[simple] eval round ${evalRoundsUsed}: contract probe fail active at cap \u2014 granting +1 retry (ggui#1261; ${capContractFails.map((i) => i.subcategory).join(", ")})`
+        );
+        return {
+          control: "feedback",
+          evalDone: false,
+          evalResult,
+          evalRoundsUsed,
+          prevModeSubcats: updatedPrevModeSubcats,
+          prevFailFingerprints: /* @__PURE__ */ new Set([...currFailFingerprints, ...capContractFails.map(fingerprintFail)]),
+          preWarmedContext,
+          evalTokens,
+          evalLlmMs,
+          lastResultText: contractLines.join("\n\n"),
+          isEvalFeedback: true,
+          lastDiffFailed: false,
+          contractFeedback: contractFeedbackRecord(capContractFails, currentSource)
+        };
+      }
       if (!allowRuntimeExtension) {
         evalResult = {
           ...evalResult,
@@ -17997,6 +18128,8 @@ function createTelemetry() {
     totalIn: 0,
     totalOut: 0,
     evalResult: void 0,
+    contractFeedback: void 0,
+    sameExchangeBreak: void 0,
     compiledCode: "",
     pairedSource: "",
     selfCheckPassed: false,
@@ -18005,6 +18138,40 @@ function createTelemetry() {
     codingMs: 0
   };
 }
+function absorbTokens(telemetry, usage) {
+  telemetry.totalIn += usage.input;
+  telemetry.totalOut += usage.output;
+  if (usage.cacheRead !== void 0) {
+    telemetry.cacheReadTokens = (telemetry.cacheReadTokens ?? 0) + usage.cacheRead;
+  }
+  if (usage.cacheCreation !== void 0) {
+    telemetry.cacheCreationTokens = (telemetry.cacheCreationTokens ?? 0) + usage.cacheCreation;
+  }
+}
+function absorbTurn(telemetry, turn) {
+  absorbTokens(telemetry, {
+    input: turn.tokens.input,
+    output: turn.tokens.output,
+    ...turn.cacheReadTokens !== void 0 ? { cacheRead: turn.cacheReadTokens } : {},
+    ...turn.cacheCreationTokens !== void 0 ? { cacheCreation: turn.cacheCreationTokens } : {}
+  });
+  telemetry.cumulativeLlmMs += turn.llmMs;
+  telemetry.cumulativeToolMs += turn.toolMs;
+  if (turn.phase) {
+    if (turn.phase === "scaffold") telemetry.counters.phases.scaffold++;
+    else if (turn.phase === "fill") telemetry.counters.phases.fill++;
+    else if (turn.phase === "impl") telemetry.counters.phases.impl++;
+    else if (turn.phase === "eval-fix") telemetry.counters.phases.evalFix++;
+    else telemetry.counters.phases.patch++;
+  }
+  if (turn.outcome) {
+    if (turn.outcome === "PASS") telemetry.counters.outcomes.pass++;
+    else if (turn.outcome === "PATCH_INVALID") telemetry.counters.outcomes.patchInvalid++;
+    else if (turn.outcome === "DIFF_FAIL") telemetry.counters.outcomes.diffFail++;
+    else telemetry.counters.outcomes.selfCheckFail++;
+  }
+  if (turn.sameExchangeBreak !== void 0) telemetry.sameExchangeBreak = turn.sameExchangeBreak;
+}
 function createGenerateTaskRunner(input) {
   const { session, params, classification, telemetry } = input;
   const maxTurns = input.maxTurns ?? 30;
@@ -18057,31 +18224,9 @@ function createGenerateTaskRunner(input) {
           preWarmPromise: session.preWarmPromise
         }
       );
-      telemetry.totalIn += turn.tokens.input;
-      telemetry.totalOut += turn.tokens.output;
-      if (turn.cacheReadTokens !== void 0) {
-        telemetry.cacheReadTokens = (telemetry.cacheReadTokens ?? 0) + turn.cacheReadTokens;
-      }
-      if (turn.cacheCreationTokens !== void 0) {
-        telemetry.cacheCreationTokens = (telemetry.cacheCreationTokens ?? 0) + turn.cacheCreationTokens;
-      }
-      telemetry.cumulativeLlmMs += turn.llmMs;
-      telemetry.cumulativeToolMs += turn.toolMs;
+      absorbTurn(telemetry, turn);
       iconNamesCache = turn.iconNamesCache;
       preWarmedContext = turn.preWarmedContext;
-      if (turn.phase) {
-        if (turn.phase === "scaffold") telemetry.counters.phases.scaffold++;
-        else if (turn.phase === "fill") telemetry.counters.phases.fill++;
-        else if (turn.phase === "impl") telemetry.counters.phases.impl++;
-        else if (turn.phase === "eval-fix") telemetry.counters.phases.evalFix++;
-        else telemetry.counters.phases.patch++;
-      }
-      if (turn.outcome) {
-        if (turn.outcome === "PASS") telemetry.counters.outcomes.pass++;
-        else if (turn.outcome === "PATCH_INVALID") telemetry.counters.outcomes.patchInvalid++;
-        else if (turn.outcome === "DIFF_FAIL") telemetry.counters.outcomes.diffFail++;
-        else telemetry.counters.outcomes.selfCheckFail++;
-      }
       if (turn.control === "break") break;
       if (turn.control === "continue") {
         lastResultText = turn.lastResultText;
@@ -18157,9 +18302,9 @@ function createGenerateTaskRunner(input) {
         prevFailFingerprints = round.prevFailFingerprints;
         preWarmedContext = round.preWarmedContext;
         if (round.evalResult) telemetry.evalResult = round.evalResult;
+        if (round.contractFeedback) telemetry.contractFeedback = round.contractFeedback;
         evalDone = round.evalDone;
-        telemetry.totalIn += round.evalTokens.input;
-        telemetry.totalOut += round.evalTokens.output;
+        absorbTokens(telemetry, round.evalTokens);
         if (round.control === "break") break;
         lastResultText = round.lastResultText;
         isEvalFeedback = round.isEvalFeedback;
@@ -18693,6 +18838,166 @@ function withArmRecord(result, params) {
   };
 }
 
+// src/pin-fixtures.ts
+var PIN_FIXTURES = [
+  {
+    userRequest: "A todo list where each item can be toggled done",
+    shellType: "chat",
+    screen: "mobile",
+    contract: {
+      propsSpec: {
+        properties: {
+          todos: {
+            required: true,
+            description: "The todos to show",
+            schema: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  id: { type: "string" },
+                  title: { type: "string" },
+                  done: { type: "boolean" }
+                }
+              }
+            }
+          }
+        }
+      },
+      actionSpec: {
+        toggleTodo: {
+          label: "Toggle",
+          description: "Flip the done state of one todo",
+          schema: {
+            type: "object",
+            properties: { id: { type: "string" } },
+            required: ["id"]
+          }
+        }
+      }
+    }
+  },
+  {
+    userRequest: "A kanban board with live task updates and a selected card",
+    shellType: "fullscreen",
+    screen: "desktop",
+    contract: {
+      propsSpec: {
+        properties: {
+          columns: {
+            required: true,
+            schema: { type: "array", items: { type: "string" } }
+          },
+          tasks: {
+            required: false,
+            schema: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  id: { type: "string" },
+                  column: { type: "string" },
+                  title: { type: "string" }
+                }
+              }
+            }
+          }
+        }
+      },
+      streamSpec: {
+        taskUpdates: {
+          description: "Task CRUD feed",
+          schema: {
+            type: "object",
+            properties: {
+              action: { type: "string", enum: ["create", "move", "edit", "delete"] },
+              id: { type: "string" }
+            }
+          }
+        }
+      },
+      contextSpec: {
+        selectedId: { schema: { type: "string", nullable: true } }
+      }
+    }
+  }
+];
+
+// src/generator-build.ts
+var TEMPLATE_FIXTURE_BOUNDARY = "\n<<<pin-fixture-boundary>>>\n";
+function templateSha256(text) {
+  return createHash("sha256").update(text, "utf8").digest("hex");
+}
+function renderPromptTemplates(designMode) {
+  return PIN_FIXTURES.map((f) => {
+    switch (designMode) {
+      case "constrained":
+        return buildSystemPrompt2(f.userRequest, f.shellType, f.screen);
+      case "free":
+        return buildSystemPrompt2(f.userRequest, f.shellType, f.screen, void 0, void 0, void 0, "free");
+    }
+  }).join(TEMPLATE_FIXTURE_BOUNDARY);
+}
+function renderBoilerplateTemplates(designMode) {
+  return PIN_FIXTURES.map((f) => {
+    switch (designMode) {
+      case "constrained":
+        return generateBoilerplate(f.userRequest, f.contract, f.shellType, f.screen);
+      case "free":
+        return generateBoilerplate(f.userRequest, f.contract, f.shellType, f.screen, void 0, void 0, "free");
+    }
+  }).join(TEMPLATE_FIXTURE_BOUNDARY);
+}
+var PACKAGE_NAME = "@ggui-ai/ui-gen";
+var MAX_PACKAGE_DEPTH = 6;
+function parsePackageJson(text) {
+  try {
+    const parsed = JSON.parse(text);
+    return parsed;
+  } catch (err) {
+    if (err instanceof SyntaxError) return void 0;
+    throw err;
+  }
+}
+function findPackageVersion(startDir = dirname(fileURLToPath(import.meta.url))) {
+  let dir = startDir;
+  for (let i = 0; i < MAX_PACKAGE_DEPTH; i++) {
+    const candidate = join(dir, "package.json");
+    const pkg = existsSync(candidate) ? parsePackageJson(readFileSync(candidate, "utf8")) : void 0;
+    if (pkg !== void 0) {
+      if (typeof pkg === "object" && pkg !== null && "name" in pkg && pkg.name === PACKAGE_NAME && "version" in pkg && typeof pkg.version === "string") {
+        return pkg.version;
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return void 0;
+}
+var versionRead = false;
+var packageVersion;
+var identities = /* @__PURE__ */ new Map();
+function generatorBuild(designMode) {
+  const key = `${designMode}|${process.env.GGUI_PITFALLS ?? ""}|${process.env.GGUI_NEW_PITFALLS ?? ""}`;
+  const known = identities.get(key);
+  if (known !== void 0) return known;
+  if (!versionRead) {
+    packageVersion = findPackageVersion();
+    versionRead = true;
+  }
+  const identity = {
+    ...packageVersion !== void 0 ? { version: packageVersion } : {},
+    mode: designMode,
+    digests: {
+      promptTemplateSha256: templateSha256(renderPromptTemplates(designMode)),
+      boilerplateTemplateSha256: templateSha256(renderBoilerplateTemplates(designMode))
+    }
+  };
+  identities.set(key, identity);
+  return identity;
+}
+
 // src/create-ui-generator.ts
 init_styling_profile();
 
@@ -18720,7 +19025,7 @@ var SHELL_HINTS = {
 - Padding: use var(--ggui-spacing-2) for inner elements, var(--ggui-spacing-4) for sections. Tight.
 - Scrolling: parent scrolls (chat feed) \u2014 component should NOT have internal scroll
 - Layout: single column, compact. No sidebar. Stack everything vertically.
-- Width: width: 100% (fills parent bubble). Do NOT set max-width.`,
+- Width: the root is width: 100% (fills the bubble) \u2014 never cap the ROOT. A prose column inside it carries the reading cap (<Container maxWidth="sm">), which is inert at bubble width.`,
   fullscreen: `**Fullscreen Shell \u2014 Takes over entire viewport**
 - Container: the whole viewport, edge to edge \u2014 the frame stretches your root to its full height (you never set a viewport height yourself)
 - Chrome: NONE \u2014 your component IS the entire UI. You own all visual chrome.
@@ -18961,6 +19266,7 @@ function injectVariance(userPrompt, variance, options) {
 }
 
 // src/create-ui-generator.ts
+init_design_mode();
 init_provider_router();
 var DEFAULT_TIER = "default";
 var DEFAULT_MODEL = "anthropic/claude-haiku-4-5";
@@ -19028,6 +19334,7 @@ function createUiGenerator(options = {}) {
         const rendering = mapRendering(input.rendering);
         const promptWithRendering = rendering ? injectRenderingContext(input.request.prompt, rendering) : input.request.prompt;
         const canvas = rendering ? canvasForRenderingContext(rendering) : void 0;
+        const shellType = harnessShellForRendering(rendering);
         const promptWithVariance = injectVariance(
           promptWithRendering,
           input.variance,
@@ -19067,6 +19374,8 @@ function createUiGenerator(options = {}) {
           ...onRetry !== void 0 ? { onRetry } : {},
           ...designMode !== void 0 ? { designMode } : {},
           ...canvas !== void 0 ? { canvas } : {},
+          // ggui#1279 — the shell the declared rendering composes for (chat only; see harnessShellForRendering).
+          ...shellType !== void 0 ? { shellType } : {},
           ...input.profile !== void 0 ? { profile: input.profile } : {},
           // Fixture props reach the in-loop probe + visual round only (never the prompt, never identity).
           ...input.fixtureProps !== void 0 ? { fixtureProps: input.fixtureProps } : {}
@@ -19081,6 +19390,8 @@ function createUiGenerator(options = {}) {
           latencyMs: Date.now() - startedAt,
           cacheHit: false,
           attempts: result.turnsUsed,
+          // ggui#1280 — the build that made this generation (template keys, never per-request).
+          build: generatorBuild(designMode ?? DEFAULT_DESIGN_MODE),
           // Prompt-cache counters are provider-specific (Claude reports
           // them; others omit). Pass through truthfully — absent on the
           // adapter result stays absent here, never defaulted to 0.
@@ -19115,7 +19426,9 @@ function createUiGenerator(options = {}) {
             inputTokens: 0,
             outputTokens: 0,
             latencyMs: Date.now() - startedAt,
-            cacheHit: false
+            cacheHit: false,
+            // ggui#1280 — a failed generation still names the build that failed.
+            build: generatorBuild(designMode ?? DEFAULT_DESIGN_MODE)
           }
         };
       } finally {
@@ -19167,6 +19480,16 @@ function mapLlmProviderToDispatchProvider(provider) {
       return "openrouter";
   }
 }
+function harnessShellForRendering(rendering) {
+  if (rendering === void 0) return void 0;
+  switch (rendering.shell) {
+    case "chat":
+      return "chat";
+    case "fullscreen":
+    case "partial":
+      return void 0;
+  }
+}
 function mapRendering(rendering) {
   if (!rendering) return void 0;
   return {