@ggui-ai/ui-gen 0.19.0 → 0.20.0

package/dist/adapters/types.d.ts

@@ -62,7 +62,7 @@ interface AdapterResult {
     subagentsUsed?: string[];
     /** Tokens written to prompt cache (Claude-specific) */
     cacheCreationTokens?: number;
-    /** Tokens read from prompt cache (Claude-specific) */
+    /** Tokens read from prompt cache (Claude / OpenRouter / OpenAI). */
     cacheReadTokens?: number;
     /** SDK session ID for evaluation loop resume (Claude SDK-specific) */
     sdkSessionId?: string;

package/dist/adapters/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/types.ts"],"names":[],"mappings":";AAcO,IAAM,sBAAA,GAAuD;AAAA,EAClE,MAAA,EAAQ,kBAAA;AAAA,EACR,MAAA,EAAQ,QAAA;AAAA,EACR,MAAA,EAAQ,eAAA;AAAA,EACR,UAAA,EAAY;AACd","file":"types.js","sourcesContent":["// packages/ui-gen/src/adapters/types.ts\n//\n// Production adapter types — used by both Lambda generation and benchmarks.\n\nimport type { z } from 'zod';\nimport type { JsonObject } from '@ggui-ai/protocol';\n\n// =============================================================================\n// Provider & Mode\n// =============================================================================\n\nexport type ProviderName = 'claude' | 'openai' | 'google' | 'openrouter';\nexport type AdapterMode = 'raw' | 'sdk' | 'multi-agent';\n\nexport const PROVIDER_DISPLAY_NAMES: Record<ProviderName, string> = {\n  claude: 'Anthropic Claude',\n  openai: 'OpenAI',\n  google: 'Google Gemini',\n  openrouter: 'OpenRouter',\n};\n\n// =============================================================================\n// Tool Definition (SDK-agnostic)\n// =============================================================================\n\nexport interface ToolResultContent {\n  type: 'text';\n  text: string;\n}\n\nexport interface ToolResult {\n  content: ToolResultContent[];\n  isError?: boolean;\n}\n\n/**\n * SDK-agnostic tool definition.\n * Each adapter converts these to its native tool format.\n */\nexport interface ToolDefinition {\n  /** Tool name (e.g., 'compile_component') */\n  name: string;\n  /** Tool description for the LLM */\n  description: string;\n  /** Zod schema for input parameters (always an object schema — tools take named args) */\n  inputSchema: z.ZodObject<z.ZodRawShape>;\n  /** Handler function — same signature regardless of SDK */\n  handler: (args: JsonObject) => Promise<ToolResult>;\n}\n\n// =============================================================================\n// Adapter Result\n// =============================================================================\n\n/**\n * Result returned by any adapter's generate() method.\n *\n * Core fields are populated by all adapters. Extended fields are\n * populated by adapters that support richer output (e.g., Claude SDK).\n */\nexport interface AdapterResult {\n  /** Final compiled JavaScript component code */\n  compiledCode: string;\n  /** TSX source code (captured from compile_component input) */\n  sourceCode?: string;\n  /** Token usage breakdown */\n  tokens: {\n    input: number;\n    output: number;\n    total: number;\n  };\n  /** Wall-clock generation time in ms */\n  generationTimeMs: number;\n  /** Total number of LLM API calls across all phases */\n  turnsUsed: number;\n  /** Number of harness iterations (Plan→Code→Evaluate→Regen cycles). 1 = single pass. */\n  iterations?: number;\n  /** Raw cost from SDK if available */\n  rawCostUsd?: number;\n\n  // ── Extended fields (production use) ───────────────────────────────\n\n  /** Data spec for ggui_emit — describes what data the component accepts */\n  stream?: JsonObject;\n  /** LLM-generated metadata annotation for blueprint indexing */\n  generatorMeta?: { category: string; description: string };\n  /** Names of subagents invoked during generation */\n  subagentsUsed?: string[];\n  /** Tokens written to prompt cache (Claude-specific) */\n  cacheCreationTokens?: number;\n  /** Tokens read from prompt cache (Claude-specific) */\n  cacheReadTokens?: number;\n  /** SDK session ID for evaluation loop resume (Claude SDK-specific) */\n  sdkSessionId?: string;\n}\n"]}
+{"version":3,"sources":["../../src/adapters/types.ts"],"names":[],"mappings":";AAcO,IAAM,sBAAA,GAAuD;AAAA,EAClE,MAAA,EAAQ,kBAAA;AAAA,EACR,MAAA,EAAQ,QAAA;AAAA,EACR,MAAA,EAAQ,eAAA;AAAA,EACR,UAAA,EAAY;AACd","file":"types.js","sourcesContent":["// packages/ui-gen/src/adapters/types.ts\n//\n// Production adapter types — used by both Lambda generation and benchmarks.\n\nimport type { z } from 'zod';\nimport type { JsonObject } from '@ggui-ai/protocol';\n\n// =============================================================================\n// Provider & Mode\n// =============================================================================\n\nexport type ProviderName = 'claude' | 'openai' | 'google' | 'openrouter';\nexport type AdapterMode = 'raw' | 'sdk' | 'multi-agent';\n\nexport const PROVIDER_DISPLAY_NAMES: Record<ProviderName, string> = {\n  claude: 'Anthropic Claude',\n  openai: 'OpenAI',\n  google: 'Google Gemini',\n  openrouter: 'OpenRouter',\n};\n\n// =============================================================================\n// Tool Definition (SDK-agnostic)\n// =============================================================================\n\nexport interface ToolResultContent {\n  type: 'text';\n  text: string;\n}\n\nexport interface ToolResult {\n  content: ToolResultContent[];\n  isError?: boolean;\n}\n\n/**\n * SDK-agnostic tool definition.\n * Each adapter converts these to its native tool format.\n */\nexport interface ToolDefinition {\n  /** Tool name (e.g., 'compile_component') */\n  name: string;\n  /** Tool description for the LLM */\n  description: string;\n  /** Zod schema for input parameters (always an object schema — tools take named args) */\n  inputSchema: z.ZodObject<z.ZodRawShape>;\n  /** Handler function — same signature regardless of SDK */\n  handler: (args: JsonObject) => Promise<ToolResult>;\n}\n\n// =============================================================================\n// Adapter Result\n// =============================================================================\n\n/**\n * Result returned by any adapter's generate() method.\n *\n * Core fields are populated by all adapters. Extended fields are\n * populated by adapters that support richer output (e.g., Claude SDK).\n */\nexport interface AdapterResult {\n  /** Final compiled JavaScript component code */\n  compiledCode: string;\n  /** TSX source code (captured from compile_component input) */\n  sourceCode?: string;\n  /** Token usage breakdown */\n  tokens: {\n    input: number;\n    output: number;\n    total: number;\n  };\n  /** Wall-clock generation time in ms */\n  generationTimeMs: number;\n  /** Total number of LLM API calls across all phases */\n  turnsUsed: number;\n  /** Number of harness iterations (Plan→Code→Evaluate→Regen cycles). 1 = single pass. */\n  iterations?: number;\n  /** Raw cost from SDK if available */\n  rawCostUsd?: number;\n\n  // ── Extended fields (production use) ───────────────────────────────\n\n  /** Data spec for ggui_emit — describes what data the component accepts */\n  stream?: JsonObject;\n  /** LLM-generated metadata annotation for blueprint indexing */\n  generatorMeta?: { category: string; description: string };\n  /** Names of subagents invoked during generation */\n  subagentsUsed?: string[];\n  /** Tokens written to prompt cache (Claude-specific) */\n  cacheCreationTokens?: number;\n  /** Tokens read from prompt cache (Claude / OpenRouter / OpenAI). */\n  cacheReadTokens?: number;\n  /** SDK session ID for evaluation loop resume (Claude SDK-specific) */\n  sdkSessionId?: string;\n}\n"]}

package/dist/advanced/index.js

@@ -22,6 +22,7 @@ import { createBrotliDecompress, createUnzip } from 'zlib';
 import { PlaywrightNotAvailableError, validateContractBehavior } from '@ggui-ai/ui-visual-tester';
 import { parseGeneratorSlug, formatGeneratorSlug, isValidGeneratorSlug } from '@ggui-ai/mcp-server-core';
 import { LUCIDE_ICON_NAMES, maxWidth } from '@ggui-ai/design';
+import { primeInputs } from '@ggui-ai/ui-visual-tester/prime-inputs';
 import git from 'isomorphic-git';
 import { Volume, createFsFromVolume } from 'memfs';
 import { createPatch, applyPatch } from 'diff';
@@ -681,6 +682,27 @@ var init_sdk = __esm({
   }
 });
 
+// src/adapters/openai/tokens.ts
+function splitOpenAiUsage(inputTokensInclCached, outputTokens, cachedTokens) {
+  const cacheRead = Math.min(
+    Math.max(cachedTokens, 0),
+    Math.max(inputTokensInclCached, 0)
+  );
+  const nonCachedInput = Math.max(inputTokensInclCached, 0) - cacheRead;
+  return {
+    tokens: {
+      input: nonCachedInput,
+      output: outputTokens,
+      total: nonCachedInput + cacheRead + outputTokens
+    },
+    cacheReadTokens: cacheRead
+  };
+}
+var init_tokens = __esm({
+  "src/adapters/openai/tokens.ts"() {
+  }
+});
+
 // src/adapters/openai/raw.ts
 var raw_exports2 = {};
 __export(raw_exports2, {
@@ -703,6 +725,7 @@ var init_raw2 = __esm({
   "src/adapters/openai/raw.ts"() {
     init_base();
     init_tool_bridge();
+    init_tokens();
     init_extract_code();
     OpenAiRawAdapter = class extends GeneratorAdapter {
       provider = "openai";
@@ -727,6 +750,7 @@ var init_raw2 = __esm({
         const capture = createCapture();
         let totalInputTokens = 0;
         let totalOutputTokens = 0;
+        let totalCachedInputTokens = 0;
         let turnsUsed = 0;
         let allTextOutput = "";
         let response = await this.client.responses.create({
@@ -742,6 +766,7 @@ var init_raw2 = __esm({
           if (response.usage) {
             totalInputTokens += response.usage.input_tokens ?? 0;
             totalOutputTokens += response.usage.output_tokens ?? 0;
+            totalCachedInputTokens += response.usage.input_tokens_details?.cached_tokens ?? 0;
           }
           const output = response.output ?? [];
           const functionCalls = output.filter(
@@ -807,11 +832,11 @@ var init_raw2 = __esm({
           sourceCode: capture.sourceCode,
           stream: capture.stream,
           generatorMeta: capture.generatorMeta,
-          tokens: {
-            input: totalInputTokens,
-            output: totalOutputTokens,
-            total: totalInputTokens + totalOutputTokens
-          },
+          ...splitOpenAiUsage(
+            totalInputTokens,
+            totalOutputTokens,
+            totalCachedInputTokens
+          ),
           generationTimeMs: Date.now() - startTime,
           turnsUsed
         };
@@ -832,6 +857,7 @@ var OpenAiSdkAdapter;
 var init_sdk2 = __esm({
   "src/adapters/openai/sdk.ts"() {
     init_base();
+    init_tokens();
     init_extract_code();
     OpenAiSdkAdapter = class extends GeneratorAdapter {
       provider = "openai";
@@ -883,16 +909,16 @@ var init_sdk2 = __esm({
         const usage = result.state.usage;
         const inputTokens = usage.inputTokens;
         const outputTokens = usage.outputTokens;
+        const cachedInputTokens = (usage.inputTokensDetails ?? []).reduce(
+          (sum, details) => sum + (details.cached_tokens ?? 0),
+          0
+        );
         return {
           compiledCode: capture.compiledCode,
           sourceCode: capture.sourceCode,
           stream: capture.stream,
           generatorMeta: capture.generatorMeta,
-          tokens: {
-            input: inputTokens,
-            output: outputTokens,
-            total: inputTokens + outputTokens
-          },
+          ...splitOpenAiUsage(inputTokens, outputTokens, cachedInputTokens),
           generationTimeMs: Date.now() - startTime,
           turnsUsed: result.rawResponses?.length ?? 0
         };
@@ -13365,6 +13391,46 @@ function runRootWidthCap(input) {
     )
   ];
 }
+var LABEL_SPECIAL_CHAR = /[^a-z0-9\s]/i;
+var normText = (s) => s.toLowerCase().replace(/\s+/g, " ").trim();
+var alnumText = (s) => s.toLowerCase().replace(/[^a-z0-9]/g, "");
+function visibleText(sourceCode) {
+  const jsx = (sourceCode.match(/>([^<>]*)</g) ?? []).map((m2) => m2.slice(1, -1).replace(/\{[^}]*\}/g, " ")).join(" ");
+  let attrs = "";
+  const attrRx = /\b(?:aria-label|placeholder|title|alt)\s*=\s*(?:"([^"]*)"|'([^']*)')/gi;
+  let m;
+  while ((m = attrRx.exec(sourceCode)) !== null) attrs += " " + (m[1] ?? m[2] ?? "");
+  return jsx + " " + attrs;
+}
+function findDroppedActionLabels(sourceCode, contract) {
+  const actionSpec = contract?.actionSpec;
+  if (actionSpec === void 0) return [];
+  if (/\.label\b/.test(sourceCode)) return [];
+  const vis = visibleText(sourceCode);
+  const normVis = normText(vis);
+  const alnumVis = alnumText(vis);
+  const out = [];
+  for (const [name, entry] of Object.entries(actionSpec)) {
+    const label = entry.label;
+    if (typeof label !== "string" || label.length === 0 || label === name) continue;
+    if (!LABEL_SPECIAL_CHAR.test(label)) continue;
+    if (alnumText(label).length < 3) continue;
+    if (normVis.includes(normText(label))) continue;
+    if (alnumVis.includes(alnumText(label))) out.push({ name, label });
+  }
+  return out;
+}
+function runActionLabelDropped(input) {
+  if (input.compiledCode === null) return [];
+  return findDroppedActionLabels(input.sourceCode, input.contract).map(
+    ({ name, label }) => mkIssue(
+      "universal.action_label_dropped",
+      `The action "${name}" declares label "${label}", but the rendered control appears to drop its "${label.replace(/[a-z0-9\s]/gi, "").trim()}": the label's words are in the generated source, the full label is not \u2014 a transcription drop (ggui#1190).`,
+      `Render the label EXACTLY as the contract states it \u2014 button text should be the verbatim \`actionSpec.${name}.label\`, or render it from data (\`{x.label}\`), never a re-typed copy that drops "&", "/", "+", etc.`,
+      "warn"
+    )
+  );
+}
 var UNIVERSAL_CHECKS = [
   {
     id: "universal.icon_name_known",
@@ -13390,6 +13456,12 @@ var UNIVERSAL_CHECKS = [
     values: ALL_RENDER_VALUES,
     run: runRootWidthCap
   },
+  {
+    id: "universal.action_label_dropped",
+    axis: "render",
+    values: ALL_RENDER_VALUES,
+    run: runActionLabelDropped
+  },
   {
     id: "universal.terminal_action_unguarded",
     axis: "render",
@@ -17619,8 +17691,6 @@ function editableSurface(el) {
 function parentLink(node) {
   return node;
 }
-
-// src/harness/check/runtime-render/render-check.ts
 async function runRenderCheck(input) {
   const g = hostGlobals();
   if ("window" in g && "document" in g) {
@@ -17799,6 +17869,10 @@ async function runRenderCheckInProcess(input) {
     let actionsChecked = 0;
     let streamsChecked = 0;
     try {
+      try {
+        primeInputs(renderResult.container);
+      } catch {
+      }
       if (input.contract?.actionSpec) {
         const actionSpec = input.contract.actionSpec;
         for (const [name, entry] of Object.entries(actionSpec)) {