@ggui-ai/ui-gen 0.20.0 → 0.22.0

package/dist/adapters/base.d.ts

@@ -11,6 +11,13 @@ interface AdapterConfig {
     apiKey?: string;
     /** Use Bedrock instead of direct API (Claude only) */
     useBedrock?: boolean;
+    /**
+     * ggui#1185 — run on the machine's own Claude Code login instead of a key.
+     * Claude SDK adapter only. The adapter strips every provider key from the
+     * spawned env and pins the run tool-less, config-less and non-bare (see
+     * `claude/claude-code-login.ts`). Opt-in; absent ⇒ key-based auth.
+     */
+    claudeCodeLogin?: boolean;
     /**
      * Thinking level for models with extended thinking (Gemini 3.x Flash
      * via the Interactions API). Mirrors the API's `thinking_level` enum —

package/dist/adapters/base.js

@@ -20,6 +20,7 @@ function stripModelPrefix(modelId) {
 function hasCredentials(config, ...envVarNames) {
   if (config.apiKey) return true;
   if (config.useBedrock) return true;
+  if (config.claudeCodeLogin) return true;
   return envVarNames.some((name) => !!process.env[name]);
 }
 

package/dist/adapters/base.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/base.ts"],"names":[],"mappings":";AAoFO,IAAe,mBAAf,MAAgC;AAAA,EAKrC,YAA+B,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiB/B,eAAe,cAAA,EAAgC;AAC7C,IAAA,OAAO,iBAAiB,cAAc,CAAA;AAAA,EACxC;AACF;AAQA,SAAS,iBAAiB,OAAA,EAAyB;AACjD,EAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,OAAA,CAAQ,GAAG,CAAA;AACtC,EAAA,OAAO,cAAc,CAAA,GAAI,OAAA,CAAQ,KAAA,CAAM,UAAA,GAAa,CAAC,CAAA,GAAI,OAAA;AAC3D;AAKO,SAAS,cAAA,CACd,WACG,WAAA,EACM;AACT,EAAA,IAAI,MAAA,CAAO,QAAQ,OAAO,IAAA;AAC1B,EAAA,IAAI,MAAA,CAAO,YAAY,OAAO,IAAA;AAC9B,EAAA,OAAO,WAAA,CAAY,KAAK,CAAC,IAAA,KAAS,CAAC,CAAC,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAC,CAAA;AACvD","file":"base.js","sourcesContent":["// packages/ui-gen/src/adapters/base.ts\n//\n// Abstract base class for all generator adapters.\n\nimport type { McpServerConfig, AgentDefinition } from '@anthropic-ai/claude-agent-sdk';\nimport type { JsonObject } from '@ggui-ai/protocol';\nimport type { AdapterResult, ToolDefinition, ProviderName, AdapterMode } from './types';\n\n/**\n * Core configuration shared by all adapters.\n */\nexport interface AdapterConfig {\n  /** API key for the provider (BYOK) */\n  apiKey?: string;\n  /** Use Bedrock instead of direct API (Claude only) */\n  useBedrock?: boolean;\n  /**\n   * Thinking level for models with extended thinking (Gemini 3.x Flash\n   * via the Interactions API). Mirrors the API's `thinking_level` enum —\n   * `'minimal'` is the floor (the API has NO true off), then `'low'` /\n   * `'medium'` / `'high'`. Omitted → provider default, and Gemini 3.5\n   * Flash defaults thinking ON with no cap — the dominant latency cost\n   * in contract-bounded UI generation. Only the Google adapter consumes\n   * this today.\n   */\n  thinkingLevel?: 'minimal' | 'low' | 'medium' | 'high';\n}\n\n/**\n * Extended configuration for Claude Agent SDK adapter.\n * Separated from AdapterConfig to avoid polluting the base interface\n * with provider-specific concerns.\n */\nexport interface ClaudeSdkConfig extends AdapterConfig {\n  /** Working directory for SDK subprocess */\n  cwd?: string;\n  /** Environment variables for SDK subprocess */\n  env?: Record<string, string>;\n  /** MCP server configs for Claude Agent SDK (keyed by name) */\n  mcpServers?: Record<string, McpServerConfig>;\n  /** Allowed tool names for Claude Agent SDK */\n  allowedTools?: string[];\n  /** Subagent definitions for Claude Agent SDK */\n  agents?: Record<string, AgentDefinition>;\n  /** Custom CLI path for Docker deployments */\n  cliPath?: string;\n  /** stderr callback for debug logging */\n  stderr?: (data: string) => void;\n  /** Progress callback */\n  onProgress?: (event: { type: string; [key: string]: unknown }) => void;\n}\n\n/**\n * Union config type — adapters accept their specific config\n * but the registry uses this union so callers can pass any config.\n */\nexport type AnyAdapterConfig = AdapterConfig | ClaudeSdkConfig;\n\n/**\n * Parameters for a single generation run.\n */\nexport interface GenerateParams {\n  /** System prompt (HOW to build — shared across all SDKs) */\n  systemPrompt: string;\n  /** User prompt (WHAT to build — the specific request) */\n  userPrompt: string;\n  /** Model identifier (provider-native format, e.g., 'claude-sonnet-4-6') */\n  model: string;\n  /** SDK-agnostic tool definitions */\n  tools: ToolDefinition[];\n  /** Maximum agentic loop turns */\n  maxTurns: number;\n  /** Model-specific options (e.g., speed_priority for Claude fast mode) */\n  modelOptions?: JsonObject;\n}\n\n/**\n * Abstract base class for generator adapters.\n *\n * Each adapter wraps a specific provider SDK (Claude, OpenAI, Google)\n * in either raw API mode or agent SDK mode, and implements the tool-use\n * loop using the SDK's native API. All adapters produce the same\n * output format (AdapterResult).\n */\nexport abstract class GeneratorAdapter {\n  abstract readonly provider: ProviderName;\n  abstract readonly mode: AdapterMode;\n  abstract readonly displayName: string;\n\n  constructor(protected readonly config: AnyAdapterConfig) {}\n\n  /**\n   * Run UI generation with the given tools, prompt, and model.\n   */\n  abstract generate(params: GenerateParams): Promise<AdapterResult>;\n\n  /**\n   * Check if this adapter can run (SDK installed, credentials available).\n   */\n  abstract isAvailable(): boolean;\n\n  /**\n   * Map a LiteLLM-format model ID to this SDK's native format.\n   * Default: strips the provider prefix (e.g., 'anthropic/claude-sonnet-4-6' -> 'claude-sonnet-4-6').\n   * Override only if the prefix convention differs.\n   */\n  resolveModelId(litellmModelId: string): string {\n    return stripModelPrefix(litellmModelId);\n  }\n}\n\n/**\n * Strip provider prefix from LiteLLM-format model IDs.\n * 'anthropic/claude-sonnet-4-6' -> 'claude-sonnet-4-6'\n * 'openai/gpt-5.3-codex' -> 'gpt-5.3-codex'\n * 'gemini/gemini-3-flash-preview' -> 'gemini-3-flash-preview'\n */\nfunction stripModelPrefix(modelId: string): string {\n  const slashIndex = modelId.indexOf('/');\n  return slashIndex >= 0 ? modelId.slice(slashIndex + 1) : modelId;\n}\n\n/**\n * Check if credentials are available from config or environment variables.\n */\nexport function hasCredentials(\n  config: AdapterConfig,\n  ...envVarNames: string[]\n): boolean {\n  if (config.apiKey) return true;\n  if (config.useBedrock) return true;\n  return envVarNames.some((name) => !!process.env[name]);\n}\n"]}
+{"version":3,"sources":["../../src/adapters/base.ts"],"names":[],"mappings":";AA2FO,IAAe,mBAAf,MAAgC;AAAA,EAKrC,YAA+B,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiB/B,eAAe,cAAA,EAAgC;AAC7C,IAAA,OAAO,iBAAiB,cAAc,CAAA;AAAA,EACxC;AACF;AAQA,SAAS,iBAAiB,OAAA,EAAyB;AACjD,EAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,OAAA,CAAQ,GAAG,CAAA;AACtC,EAAA,OAAO,cAAc,CAAA,GAAI,OAAA,CAAQ,KAAA,CAAM,UAAA,GAAa,CAAC,CAAA,GAAI,OAAA;AAC3D;AAKO,SAAS,cAAA,CACd,WACG,WAAA,EACM;AACT,EAAA,IAAI,MAAA,CAAO,QAAQ,OAAO,IAAA;AAC1B,EAAA,IAAI,MAAA,CAAO,YAAY,OAAO,IAAA;AAC9B,EAAA,IAAI,MAAA,CAAO,iBAAiB,OAAO,IAAA;AACnC,EAAA,OAAO,WAAA,CAAY,KAAK,CAAC,IAAA,KAAS,CAAC,CAAC,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAC,CAAA;AACvD","file":"base.js","sourcesContent":["// packages/ui-gen/src/adapters/base.ts\n//\n// Abstract base class for all generator adapters.\n\nimport type { McpServerConfig, AgentDefinition } from '@anthropic-ai/claude-agent-sdk';\nimport type { JsonObject } from '@ggui-ai/protocol';\nimport type { AdapterResult, ToolDefinition, ProviderName, AdapterMode } from './types';\n\n/**\n * Core configuration shared by all adapters.\n */\nexport interface AdapterConfig {\n  /** API key for the provider (BYOK) */\n  apiKey?: string;\n  /** Use Bedrock instead of direct API (Claude only) */\n  useBedrock?: boolean;\n  /**\n   * ggui#1185 — run on the machine's own Claude Code login instead of a key.\n   * Claude SDK adapter only. The adapter strips every provider key from the\n   * spawned env and pins the run tool-less, config-less and non-bare (see\n   * `claude/claude-code-login.ts`). Opt-in; absent ⇒ key-based auth.\n   */\n  claudeCodeLogin?: boolean;\n  /**\n   * Thinking level for models with extended thinking (Gemini 3.x Flash\n   * via the Interactions API). Mirrors the API's `thinking_level` enum —\n   * `'minimal'` is the floor (the API has NO true off), then `'low'` /\n   * `'medium'` / `'high'`. Omitted → provider default, and Gemini 3.5\n   * Flash defaults thinking ON with no cap — the dominant latency cost\n   * in contract-bounded UI generation. Only the Google adapter consumes\n   * this today.\n   */\n  thinkingLevel?: 'minimal' | 'low' | 'medium' | 'high';\n}\n\n/**\n * Extended configuration for Claude Agent SDK adapter.\n * Separated from AdapterConfig to avoid polluting the base interface\n * with provider-specific concerns.\n */\nexport interface ClaudeSdkConfig extends AdapterConfig {\n  /** Working directory for SDK subprocess */\n  cwd?: string;\n  /** Environment variables for SDK subprocess */\n  env?: Record<string, string>;\n  /** MCP server configs for Claude Agent SDK (keyed by name) */\n  mcpServers?: Record<string, McpServerConfig>;\n  /** Allowed tool names for Claude Agent SDK */\n  allowedTools?: string[];\n  /** Subagent definitions for Claude Agent SDK */\n  agents?: Record<string, AgentDefinition>;\n  /** Custom CLI path for Docker deployments */\n  cliPath?: string;\n  /** stderr callback for debug logging */\n  stderr?: (data: string) => void;\n  /** Progress callback */\n  onProgress?: (event: { type: string; [key: string]: unknown }) => void;\n}\n\n/**\n * Union config type — adapters accept their specific config\n * but the registry uses this union so callers can pass any config.\n */\nexport type AnyAdapterConfig = AdapterConfig | ClaudeSdkConfig;\n\n/**\n * Parameters for a single generation run.\n */\nexport interface GenerateParams {\n  /** System prompt (HOW to build — shared across all SDKs) */\n  systemPrompt: string;\n  /** User prompt (WHAT to build — the specific request) */\n  userPrompt: string;\n  /** Model identifier (provider-native format, e.g., 'claude-sonnet-4-6') */\n  model: string;\n  /** SDK-agnostic tool definitions */\n  tools: ToolDefinition[];\n  /** Maximum agentic loop turns */\n  maxTurns: number;\n  /** Model-specific options (e.g., speed_priority for Claude fast mode) */\n  modelOptions?: JsonObject;\n}\n\n/**\n * Abstract base class for generator adapters.\n *\n * Each adapter wraps a specific provider SDK (Claude, OpenAI, Google)\n * in either raw API mode or agent SDK mode, and implements the tool-use\n * loop using the SDK's native API. All adapters produce the same\n * output format (AdapterResult).\n */\nexport abstract class GeneratorAdapter {\n  abstract readonly provider: ProviderName;\n  abstract readonly mode: AdapterMode;\n  abstract readonly displayName: string;\n\n  constructor(protected readonly config: AnyAdapterConfig) {}\n\n  /**\n   * Run UI generation with the given tools, prompt, and model.\n   */\n  abstract generate(params: GenerateParams): Promise<AdapterResult>;\n\n  /**\n   * Check if this adapter can run (SDK installed, credentials available).\n   */\n  abstract isAvailable(): boolean;\n\n  /**\n   * Map a LiteLLM-format model ID to this SDK's native format.\n   * Default: strips the provider prefix (e.g., 'anthropic/claude-sonnet-4-6' -> 'claude-sonnet-4-6').\n   * Override only if the prefix convention differs.\n   */\n  resolveModelId(litellmModelId: string): string {\n    return stripModelPrefix(litellmModelId);\n  }\n}\n\n/**\n * Strip provider prefix from LiteLLM-format model IDs.\n * 'anthropic/claude-sonnet-4-6' -> 'claude-sonnet-4-6'\n * 'openai/gpt-5.3-codex' -> 'gpt-5.3-codex'\n * 'gemini/gemini-3-flash-preview' -> 'gemini-3-flash-preview'\n */\nfunction stripModelPrefix(modelId: string): string {\n  const slashIndex = modelId.indexOf('/');\n  return slashIndex >= 0 ? modelId.slice(slashIndex + 1) : modelId;\n}\n\n/**\n * Check if credentials are available from config or environment variables.\n */\nexport function hasCredentials(\n  config: AdapterConfig,\n  ...envVarNames: string[]\n): boolean {\n  if (config.apiKey) return true;\n  if (config.useBedrock) return true;\n  if (config.claudeCodeLogin) return true;\n  return envVarNames.some((name) => !!process.env[name]);\n}\n"]}

package/dist/adapters/generation-dispatch.d.ts

@@ -1,8 +1,8 @@
 import { EvaluationConfig } from '../evaluation/types.js';
 import { ModelRoles, GenerationResult } from '../harness/result-types.js';
 import { ProviderName, ToolDefinition } from './types.js';
-import { Q as QualityConfig } from '../types-public-DKR_h70H.js';
-import { A as AgentConfig } from '../llm-router-D7fjBhtr.js';
+import { Q as QualityConfig } from '../types-public-mM_-1Yk3.js';
+import { A as AgentConfig } from '../llm-router-DwwUK1bz.js';
 import { DataContract, JsonObject, GadgetDescriptor } from '@ggui-ai/protocol';
 import { C as CanvasClass, D as DesignMode } from '../design-mode-DLufhrNp.js';
 import { G as GenerationProfileInput } from '../styling-profile-CxfvV48g.js';
@@ -56,6 +56,15 @@ interface GenerationDispatchParams {
          * today's single screenshot at `viewport`.
          */
         canvases?: readonly CanvasClass[];
+        /**
+         * ggui#1195 — per-canvas viewport override for the in-loop round: the
+         * box the composer targeted (`rendering.viewport`) so the round judges
+         * the same box. See `VisualEvalConfig.canvasViewports`.
+         */
+        canvasViewports?: Partial<Readonly<Record<CanvasClass, {
+            width: number;
+            height: number;
+        }>>>;
     };
     /** Quality config controlling eval tiers and improvement behavior */
     qualityConfig?: QualityConfig;
@@ -133,7 +142,12 @@ interface GenerationDispatchParams {
      * means `constrained` (byte-identical to the pre-`designMode` path).
      */
     designMode?: DesignMode;
-    /** Rendering canvas class for the `free` prompt — see `CreateHarnessInput.canvas`. */
+    /**
+     * Rendering canvas class — see `CreateHarnessInput.canvas`. Absent, the
+     * harness derives it from `shellType` × `screen` (ggui#1117), so the axis
+     * checks always judge for the canvas the generation renders on; the
+     * `free` prompt renders it, the constrained prompt ignores it.
+     */
     canvas?: CanvasClass;
     /** The app's generation profile (#991). */
     profile?: GenerationProfileInput;