@ggui-ai/ui-gen 0.28.0 → 0.29.0

package/dist/harness/validator-trace-sink.d.ts

@@ -1,9 +1,10 @@
 import { C as Classification } from '../axes-CKVCzR_x.js';
-import { E as EvalIssue } from '../types-public-h8IMnYuh.js';
+import { E as EvalIssue } from '../types-public-hYlrerZh.js';
 import '@ggui-ai/protocol';
 import '../llm.js';
 import '@ggui-ai/mcp-server-core';
-import '../design-mode-DGWN_Gkm.js';
+import '../design-mode-XyOQmzE0.js';
+import '@ggui-ai/design/rendering';
 import '../types-Dh1s4K9j.js';
 
 /**

package/dist/harness/validator-trace-sink.js

@@ -1,28 +1,4 @@
-// src/harness/validator-trace-sink.ts
-var activeSink = null;
-function setValidatorTraceSink(sink) {
-  activeSink = sink;
-}
-function getValidatorTraceSink() {
-  return activeSink;
-}
-function emitValidatorTraceEvent(event) {
-  const sink = activeSink;
-  if (!sink) return;
-  try {
-    sink.emit(event);
-  } catch {
-  }
-}
-function truncateSourceForTrace(source) {
-  const cap = 16 * 1024;
-  if (source.length <= cap) return source;
-  return source.slice(0, cap) + "\n\n/* \u2026 truncated for devtools trace \u2026 */";
-}
-function newValidatorTraceId() {
-  return Date.now().toString(36) + Math.random().toString(36).slice(2, 10);
-}
-
-export { emitValidatorTraceEvent, getValidatorTraceSink, newValidatorTraceId, setValidatorTraceSink, truncateSourceForTrace };
+export { emitValidatorTraceEvent, getValidatorTraceSink, newValidatorTraceId, setValidatorTraceSink, truncateSourceForTrace } from '../chunk-WYHP46LT.js';
+import '../chunk-G3PMV62Z.js';
 //# sourceMappingURL=validator-trace-sink.js.map
 //# sourceMappingURL=validator-trace-sink.js.map

package/dist/harness/validator-trace-sink.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/harness/validator-trace-sink.ts"],"names":[],"mappings":";AAgGA,IAAI,UAAA,GAAwC,IAAA;AAMrC,SAAS,sBAAsB,IAAA,EAAuC;AAC3E,EAAA,UAAA,GAAa,IAAA;AACf;AAGO,SAAS,qBAAA,GAAmD;AACjE,EAAA,OAAO,UAAA;AACT;AAOO,SAAS,wBAAwB,KAAA,EAAkC;AACxE,EAAA,MAAM,IAAA,GAAO,UAAA;AACb,EAAA,IAAI,CAAC,IAAA,EAAM;AACX,EAAA,IAAI;AACF,IAAA,IAAA,CAAK,KAAK,KAAK,CAAA;AAAA,EACjB,CAAA,CAAA,MAAQ;AAAA,EAER;AACF;AAMO,SAAS,uBAAuB,MAAA,EAAwB;AAC7D,EAAA,MAAM,MAAM,EAAA,GAAK,IAAA;AACjB,EAAA,IAAI,MAAA,CAAO,MAAA,IAAU,GAAA,EAAK,OAAO,MAAA;AACjC,EAAA,OAAO,MAAA,CAAO,KAAA,CAAM,CAAA,EAAG,GAAG,CAAA,GAAI,sDAAA;AAChC;AAMO,SAAS,mBAAA,GAA8B;AAC5C,EAAA,OACE,IAAA,CAAK,GAAA,EAAI,CAAE,QAAA,CAAS,EAAE,CAAA,GACtB,IAAA,CAAK,MAAA,EAAO,CAAE,QAAA,CAAS,EAAE,CAAA,CAAE,KAAA,CAAM,GAAG,EAAE,CAAA;AAE1C","file":"validator-trace-sink.js","sourcesContent":["/**\n * Live validator-tier trace sink — devtools introspection of every\n * `runCheck()` invocation the harness performs.\n *\n * **Distinct from {@link LlmTraceSink}, {@link TelemetrySink}, and\n * {@link AuditSink}.**\n *   - **LLM trace** (sibling) = devtools-only ring buffer of LLM call\n *     payloads (system + user prompt, tools, completion, tokens).\n *     Answers \"what did the LLM see / say?\".\n *   - **Telemetry** (mcp-server-core) = ops signals (`pair.completed`,\n *     `render.duration_ms`). Lossy. Flat scalars.\n *   - **Audit** (mcp-server-core) = compliance log of privileged\n *     mutations. Durable.\n *   - **Validator trace** (this) = devtools-only ring buffer of every\n *     `runCheck()` call's full validator-tier breakdown — which axis /\n *     tier / runtime-render / LLM checks fired, what each returned\n *     (pass/fail/warn issues with description, fix, line, severity).\n *     Answers \"which check failed, and what did the LLM emit?\".\n *\n * **Why module-level registry instead of constructor injection.** Same\n * argument as the LLM trace sink — `runCheck()` is called from multiple\n * orchestrator entrypoints (`runHarness`, `run-eval-round`) across the\n * harness package; threading a sink through every call site for a\n * devtools-only surface isn't worth the churn. The ggui server is\n * single-process per CLI invocation; a hosted runtime isolates per\n * request via a process pool.\n *\n * **Default = no sink.** When unset, `runCheck` emits nothing and spends\n * no CPU formatting events. Passing `null` removes a previously\n * registered sink.\n */\nimport type { Classification } from \"../classifier/axes.js\";\nimport type { EvalIssue } from \"../evaluation/types-public.js\";\n\n/**\n * One `runCheck()` invocation. Emitted **after** all tiers complete\n * (success or partial — even when one tier throws, the others ran and\n * we surface what we have). Single event per call.\n */\nexport interface ValidatorTraceEvent {\n  /** Random per-event ID. */\n  readonly id: string;\n  /** Epoch ms when `runCheck` was entered. */\n  readonly at: number;\n  /** Epoch ms when `runCheck` returned. */\n  readonly endedAt: number;\n  /** `endedAt - at` — convenience. */\n  readonly durationMs: number;\n  /** Harness fingerprint that drove these checks. */\n  readonly harnessId: string;\n  /** Classification axes that produced the harness — useful when the\n   *  operator asks \"why did this axis-check fire?\". */\n  readonly classification: Classification;\n  /** Workflow that produced the source-under-check. */\n  readonly workflowId: string;\n  /** Was a non-null compiledCode fed in? When false, runCheck short-\n   *  circuits to an empty result — surfaced for transparency. */\n  readonly hadCompiledCode: boolean;\n  /** Was the runtime-render probe deliberately skipped? Mirrors the\n   *  `skipRuntimeRender` input flag. */\n  readonly skippedRuntimeRender: boolean;\n  /** Per-tier issue counts and which check ids fired. */\n  readonly summary: {\n    readonly totalIssues: number;\n    readonly axisIssues: number;\n    readonly tierIssues: number;\n    readonly llmIssues: number;\n    readonly runtimeRenderIssues: number;\n    readonly firedCheckIds: readonly string[];\n  };\n  /** Every issue emitted across all tiers. Carries description + fix +\n   *  line + severity + tier + category — the full per-issue payload the\n   *  validator UI renders into a per-tier breakdown. */\n  readonly issues: readonly EvalIssue[];\n  /** Source under check — capped at ~16KB. Operators expanding a card\n   *  want to see what failed; longer sources are truncated with a\n   *  trailing marker so the UI shows the truncation honestly. */\n  readonly sourceCode?: string;\n  /** Original prompt — useful when \"this passed eval but doesn't match\n   *  the request\" comes up in operator triage. */\n  readonly prompt?: string;\n  /** Set when `runCheck` itself threw before completing. The event is\n   *  still emitted (devtools want to see partial / failed runs). */\n  readonly error?: { readonly message: string };\n}\n\n/**\n * Sink that receives one event per `runCheck()` invocation. Same\n * contract as {@link LlmTraceSink} — implementations MUST be sync +\n * non-throwing. Buffer + drop or fan out to a queue inside the\n * implementation.\n */\nexport interface ValidatorTraceSink {\n  emit(event: ValidatorTraceEvent): void;\n}\n\nlet activeSink: ValidatorTraceSink | null = null;\n\n/**\n * Register the active sink. Pass `null` to remove. Subsequent\n * {@link emitValidatorTraceEvent} calls dispatch to this sink.\n */\nexport function setValidatorTraceSink(sink: ValidatorTraceSink | null): void {\n  activeSink = sink;\n}\n\n/** Read the active sink. Mostly for tests. */\nexport function getValidatorTraceSink(): ValidatorTraceSink | null {\n  return activeSink;\n}\n\n/**\n * Internal — used by `runCheck`. No-op when no sink is registered.\n * Swallows sink-thrown errors (a broken devtools sink must not break\n * generation).\n */\nexport function emitValidatorTraceEvent(event: ValidatorTraceEvent): void {\n  const sink = activeSink;\n  if (!sink) return;\n  try {\n    sink.emit(event);\n  } catch {\n    // Devtools sink is allowed to be buggy — generation must not die.\n  }\n}\n\n/**\n * Truncate a source string to ~16KB so a runaway component doesn't\n * blow the per-event memory budget. Adds a visible truncation marker.\n */\nexport function truncateSourceForTrace(source: string): string {\n  const cap = 16 * 1024;\n  if (source.length <= cap) return source;\n  return source.slice(0, cap) + \"\\n\\n/* … truncated for devtools trace … */\";\n}\n\n/**\n * Crockford-style random ID. Same approach as the LLM trace sink —\n * dep-free for any runtime the harness might run in.\n */\nexport function newValidatorTraceId(): string {\n  return (\n    Date.now().toString(36) +\n    Math.random().toString(36).slice(2, 10)\n  );\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"validator-trace-sink.js"}

package/dist/hash.js

@@ -1,41 +1,4 @@
-import { createHash } from 'crypto';
-
-// src/hash.ts
-function stableStringify(value) {
-  if (value === null) return "null";
-  if (typeof value === "number") return Number.isFinite(value) ? JSON.stringify(value) : "null";
-  if (typeof value === "string") return JSON.stringify(value);
-  if (typeof value === "boolean") return value ? "true" : "false";
-  if (Array.isArray(value)) return `[${value.map(stableStringify).join(",")}]`;
-  if (typeof value === "object") {
-    const keys = Object.keys(value).sort();
-    const parts = keys.map(
-      (k) => `${JSON.stringify(k)}:${stableStringify(value[k])}`
-    );
-    return `{${parts.join(",")}}`;
-  }
-  return "null";
-}
-function shortHash(input) {
-  return createHash("sha256").update(input).digest("hex").slice(0, 12);
-}
-function hashClassification(c) {
-  return shortHash(stableStringify({ vector: c.vector, riskTier: c.riskTier }));
-}
-function computeHarnessId(input) {
-  return shortHash(stableStringify(input));
-}
-function computeHarnessName(input) {
-  const v = input.classification.vector;
-  const dominantAxes = [];
-  if (v.state !== "none") dominantAxes.push(`state=${v.state}`);
-  if (v.writes !== "none") dominantAxes.push(`writes=${v.writes}`);
-  if (v.realtime !== "none") dominantAxes.push(`realtime=${v.realtime}`);
-  if (v.tooling !== "none") dominantAxes.push(`tooling=${v.tooling}`);
-  const axesPart = dominantAxes.length > 0 ? dominantAxes.join("+") : "passive";
-  return `${input.version}/${axesPart}/${input.workflowName}`;
-}
-
-export { computeHarnessId, computeHarnessName, hashClassification };
+export { computeHarnessId, computeHarnessName, hashClassification } from './chunk-DUU3ZJDQ.js';
+import './chunk-G3PMV62Z.js';
 //# sourceMappingURL=hash.js.map
 //# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hash.ts"],"names":[],"mappings":";;;AAqBA,SAAS,gBAAgB,KAAA,EAAwB;AAC/C,EAAA,IAAI,KAAA,KAAU,MAAM,OAAO,MAAA;AAC3B,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,OAAO,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,GAAI,IAAA,CAAK,SAAA,CAAU,KAAK,CAAA,GAAI,MAAA;AACvF,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,OAAO,IAAA,CAAK,UAAU,KAAK,CAAA;AAC1D,EAAA,IAAI,OAAO,KAAA,KAAU,SAAA,EAAW,OAAO,QAAQ,MAAA,GAAS,OAAA;AACxD,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG,OAAO,CAAA,CAAA,EAAI,KAAA,CAAM,GAAA,CAAI,eAAe,CAAA,CAAE,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA,CAAA;AACzE,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,MAAM,IAAA,GAAO,MAAA,CAAO,IAAA,CAAK,KAAgC,EAAE,IAAA,EAAK;AAChE,IAAA,MAAM,QAAQ,IAAA,CAAK,GAAA;AAAA,MACjB,CAAC,CAAA,KACC,CAAA,EAAG,IAAA,CAAK,SAAA,CAAU,CAAC,CAAC,CAAA,CAAA,EAAI,eAAA,CAAiB,KAAA,CAAkC,CAAC,CAAC,CAAC,CAAA;AAAA,KAClF;AACA,IAAA,OAAO,CAAA,CAAA,EAAI,KAAA,CAAM,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA,CAAA;AAAA,EAC5B;AACA,EAAA,OAAO,MAAA;AACT;AAEA,SAAS,UAAU,KAAA,EAAuB;AACxC,EAAA,OAAO,UAAA,CAAW,QAAQ,CAAA,CAAE,MAAA,CAAO,KAAK,CAAA,CAAE,MAAA,CAAO,KAAK,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA;AACrE;AAKO,SAAS,mBAAmB,CAAA,EAA2B;AAC5D,EAAA,OAAO,SAAA,CAAU,eAAA,CAAgB,EAAE,MAAA,EAAQ,CAAA,CAAE,QAAQ,QAAA,EAAU,CAAA,CAAE,QAAA,EAAU,CAAC,CAAA;AAC9E;AAUO,SAAS,iBAAiB,KAAA,EAStB;AACT,EAAA,OAAO,SAAA,CAAU,eAAA,CAAgB,KAAK,CAAC,CAAA;AACzC;AAMO,SAAS,mBAAmB,KAAA,EAIxB;AACT,EAAA,MAAM,CAAA,GAAI,MAAM,cAAA,CAAe,MAAA;AAC/B,EAAA,MAAM,eAAyB,EAAC;AAChC,EAAA,IAAI,CAAA,CAAE,UAAU,MAAA,EAAQ,YAAA,CAAa,KAAK,CAAA,MAAA,EAAS,CAAA,CAAE,KAAK,CAAA,CAAE,CAAA;AAC5D,EAAA,IAAI,CAAA,CAAE,WAAW,MAAA,EAAQ,YAAA,CAAa,KAAK,CAAA,OAAA,EAAU,CAAA,CAAE,MAAM,CAAA,CAAE,CAAA;AAC/D,EAAA,IAAI,CAAA,CAAE,aAAa,MAAA,EAAQ,YAAA,CAAa,KAAK,CAAA,SAAA,EAAY,CAAA,CAAE,QAAQ,CAAA,CAAE,CAAA;AACrE,EAAA,IAAI,CAAA,CAAE,YAAY,MAAA,EAAQ,YAAA,CAAa,KAAK,CAAA,QAAA,EAAW,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA;AAClE,EAAA,MAAM,WAAW,YAAA,CAAa,MAAA,GAAS,IAAI,YAAA,CAAa,IAAA,CAAK,GAAG,CAAA,GAAI,SAAA;AACpE,EAAA,OAAO,GAAG,KAAA,CAAM,OAAO,IAAI,QAAQ,CAAA,CAAA,EAAI,MAAM,YAAY,CAAA,CAAA;AAC3D","file":"hash.js","sourcesContent":["// packages/ui-gen/src/hash.ts\n//\n// Deterministic fingerprint helpers for harness composition. Two inputs\n// that are structurally equivalent hash to the same 12-char prefix; two\n// different inputs hash to different prefixes.\n//\n// Used for:\n//  - Harness id attribution (log + benchmark cell tagging)\n//  - Prompt-cache key reuse\n//  - Comparison-validity checks when benchmarking harness variants\n//\n// The `stableStringify` + `shortHash` primitives are private\n// implementation detail of this module.\n\nimport { createHash } from \"node:crypto\";\nimport type { Classification } from \"./classifier/axes.js\";\n\n// ─── Private primitives ────────────────────────────────────────────────────\n// Not exported — these are implementation detail. If an external consumer\n// needs a stable hash of arbitrary data, they should do it themselves.\n\nfunction stableStringify(value: unknown): string {\n  if (value === null) return \"null\";\n  if (typeof value === \"number\") return Number.isFinite(value) ? JSON.stringify(value) : \"null\";\n  if (typeof value === \"string\") return JSON.stringify(value);\n  if (typeof value === \"boolean\") return value ? \"true\" : \"false\";\n  if (Array.isArray(value)) return `[${value.map(stableStringify).join(\",\")}]`;\n  if (typeof value === \"object\") {\n    const keys = Object.keys(value as Record<string, unknown>).sort();\n    const parts = keys.map(\n      (k) =>\n        `${JSON.stringify(k)}:${stableStringify((value as Record<string, unknown>)[k])}`,\n    );\n    return `{${parts.join(\",\")}}`;\n  }\n  return \"null\";\n}\n\nfunction shortHash(input: string): string {\n  return createHash(\"sha256\").update(input).digest(\"hex\").slice(0, 12);\n}\n\n// ─── Public surface ────────────────────────────────────────────────────────\n\n/** Hash a classification — used as a sub-component of the harness id. */\nexport function hashClassification(c: Classification): string {\n  return shortHash(stableStringify({ vector: c.vector, riskTier: c.riskTier }));\n}\n\n/**\n * Compute a harness id from the materialized pieces. Called by `createHarness`\n * after all legs are built.\n *\n * Hashes only the stable content — not function references (applyPatch,\n * planner, etc.) because function identity isn't serializable. Instead,\n * version tags bump when semantics change.\n */\nexport function computeHarnessId(input: {\n  classificationHash: string;\n  howVersion: string;\n  whatVersion: string;\n  checkVersion: string;\n  processVersion: string;\n  workflowId: string;\n  fragmentIds: readonly string[];\n  overrides: readonly string[];\n}): string {\n  return shortHash(stableStringify(input));\n}\n\n/**\n * Human-readable harness name. Deterministic but informative — derives from\n * classification + workflow without needing to look up the id.\n */\nexport function computeHarnessName(input: {\n  classification: Classification;\n  workflowName: string;\n  version: string;\n}): string {\n  const v = input.classification.vector;\n  const dominantAxes: string[] = [];\n  if (v.state !== \"none\") dominantAxes.push(`state=${v.state}`);\n  if (v.writes !== \"none\") dominantAxes.push(`writes=${v.writes}`);\n  if (v.realtime !== \"none\") dominantAxes.push(`realtime=${v.realtime}`);\n  if (v.tooling !== \"none\") dominantAxes.push(`tooling=${v.tooling}`);\n  const axesPart = dominantAxes.length > 0 ? dominantAxes.join(\"+\") : \"passive\";\n  return `${input.version}/${axesPart}/${input.workflowName}`;\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"hash.js"}

package/dist/hashline-5OKREIRM.js

@@ -0,0 +1,4 @@
+export { computeLineHash, formatHashlineStaleMessage, formatWithHashlines, parseHashlineRef, validateHashlineRefs } from './chunk-4MBR5GA3.js';
+import './chunk-G3PMV62Z.js';
+//# sourceMappingURL=hashline-5OKREIRM.js.map
+//# sourceMappingURL=hashline-5OKREIRM.js.map

package/dist/hashline-5OKREIRM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"hashline-5OKREIRM.js"}

package/dist/index.d.ts

@@ -1,22 +1,23 @@
-export { C as CreateUiGeneratorOptions, c as createUiGenerator, e as extractComponentCode } from './create-ui-generator-BrZHF0cf.js';
-export { R as RuntimeRenderProbeConfig } from './adapter-h4_V69LI.js';
-import { Q as QualityConfig } from './types-public-h8IMnYuh.js';
-export { P as ProviderRetryInfo } from './types-public-h8IMnYuh.js';
+export { C as CreateUiGeneratorOptions, c as createUiGenerator, e as extractComponentCode } from './create-ui-generator-BY-WeaPi.js';
+export { R as RuntimeRenderProbeConfig } from './adapter-DLQ-5COm.js';
+import { Q as QualityConfig } from './types-public-hYlrerZh.js';
+export { P as ProviderRetryInfo, r as ProviderSdkPreload, s as preloadProviderSdks } from './types-public-hYlrerZh.js';
 export { GenerationResult, SameExchangeBreak, SameFailureBreak } from './harness/result-types.js';
 import { GeneratorBuild, UiGenerator } from '@ggui-ai/mcp-server-core';
-import { D as DesignMode } from './design-mode-DGWN_Gkm.js';
-export { b as CANVAS_BREAKPOINTS, c as CANVAS_CLASSES, d as CANVAS_DESCRIPTORS, e as CANVAS_VIEWPORTS, C as CanvasClass, f as CanvasDescriptor, g as CanvasDisplayMode, a as CanvasViewport, h as DEFAULT_DESIGN_MODE, i as DESIGN_MODES, j as canvasDisplayModeForShell, k as canvasForRendering, l as canvasForViewportWidth, m as describeCanvas } from './design-mode-DGWN_Gkm.js';
+import { D as DesignMode } from './design-mode-XyOQmzE0.js';
+export { a as CANVAS_BREAKPOINTS, b as CANVAS_DESCRIPTORS, c as CANVAS_VIEWPORTS, d as CanvasDescriptor, e as CanvasDisplayMode, C as CanvasViewport, f as DEFAULT_DESIGN_MODE, g as DESIGN_MODES, h as canvasDisplayModeForShell, i as canvasForRendering, j as canvasForViewportWidth, k as describeCanvas } from './design-mode-XyOQmzE0.js';
 export { CreateInMemoryGeneratorRegistryOptions, createInMemoryGeneratorRegistry } from '@ggui-ai/mcp-server-core/in-memory';
-export { R as RenderingContext, b as buildContractsContext, a as buildRenderingContext, c as buildVarianceContext, d as canvasForRenderingContext, i as injectContracts, e as injectRenderingContext, f as injectVariance } from './prompts-BhNUuRoZ.js';
+export { R as RenderingContext, b as buildContractsContext, a as buildRenderingContext, c as buildVarianceContext, d as canvasForRenderingContext, i as injectContracts, e as injectRenderingContext, f as injectVariance } from './prompts-CLZGywMP.js';
 import { LLMToolDef } from './llm.js';
 import Anthropic from '@anthropic-ai/sdk';
 export { A as AESTHETIC_BRIEF_MAX_CHARS, G as GenerationProfileInput } from './styling-profile-CxfvV48g.js';
 export { VisualEvalAgentSpec } from './adapters/generation-dispatch.js';
 import { AppGenerationProfileEffort, ModelTier } from '@ggui-ai/protocol';
+export { CANVAS_CLASSES, CanvasClass } from '@ggui-ai/design/rendering';
 import './harness/runtime.js';
-import './bank-Ctdp3FUA.js';
+import './bank-LWaiAtaA.js';
 import 'zod';
-import './generate-tSO_shQ0.js';
+import './generate-DQ4ci90s.js';
 import './axes-CKVCzR_x.js';
 import './types-Dh1s4K9j.js';
 import '@ggui-ai/gadgets';
@@ -24,9 +25,47 @@ import './evaluation/types.js';
 import './harness/types-public.js';
 import './policy.js';
 import './adapters/types.js';
-import './visual-evaluator-C2strxqD.js';
+import './visual-evaluator-KskajxD5.js';
 import 'puppeteer-core';
 
+/**
+ * The one runtime load of `@anthropic-ai/claude-agent-sdk` (ggui#1951).
+ *
+ * The SDK is an OPTIONAL peer of this package, not a dependency. Its
+ * per-platform native binary is about 300 MB, and only the Claude Code
+ * login route (`routeOverride.claudeCodeLogin`, `ggui serve
+ * --local-cli-login`), the `sdk`-mode Claude adapter and the
+ * `./evaluation` loop run it. A plain install therefore does not carry
+ * it, and every one of those paths loads it through
+ * {@link loadClaudeAgentSdk}: a missing SDK fails with one
+ * {@link ClaudeAgentSdkMissingError} that names the install line for
+ * each way of installing ggui, and every other failure keeps its own
+ * shape.
+ *
+ * `preloadProviderSdks` (in `./llm-router.ts`) imports the SDK directly
+ * on purpose: it reports a missing SDK in its `missing` list and never
+ * throws.
+ */
+/** The package specifier, as it is imported and installed. */
+declare const CLAUDE_AGENT_SDK_SPECIFIER = "@anthropic-ai/claude-agent-sdk";
+/**
+ * The exact version this package's `peerDependencies` names. The install
+ * lines in {@link ClaudeAgentSdkMissingError} use it; a test pins it to
+ * `package.json`.
+ */
+declare const CLAUDE_AGENT_SDK_VERSION = "0.3.229";
+/** The SDK is not installed where this package can import it. */
+declare class ClaudeAgentSdkMissingError extends Error {
+    constructor(cause: Error);
+}
+/**
+ * Check that the Claude Agent SDK loads, with the same errors as
+ * {@link loadClaudeAgentSdk}, for a host that wants to say so at boot
+ * (`ggui serve --local-cli-login`). Its signature names none of the SDK's
+ * types, so the package's main entry can export it. `importer` is for tests.
+ */
+declare function ensureClaudeAgentSdk(importer?: () => Promise<unknown>): Promise<void>;
+
 /**
  * ui-gen's precise {@link GeneratorBuild}: the core port's generic shape with
  * ui-gen's own keys — `mode` is the design mode, and `digests` names the two
@@ -238,4 +277,4 @@ declare const EFFORT_DIALS: Readonly<Record<AppGenerationProfileEffort, EffortDi
 /** The dials for a named level; `undefined` when no level is named (the deployment's options stand). */
 declare function effortDials(effort: AppGenerationProfileEffort | undefined): EffortDials | undefined;
 
-export { CLAUDE_CODE_LOGIN_CREDENTIAL, CompileComponentCodeError, DesignMode, EFFORT_DIALS, EFFORT_TABLE_VERSION, type EffortDials, HARNESS_CODING_TOOLS, HARNESS_SCOPED_TOOLS, type InLoopEvaluationSwitches, type UiGenBuild, compileComponentCode, createAnthropicClient, effortDials, generatorBuild, harnessToolEntry, harnessToolNames, inLoopEvaluation, runsInLoopEvaluation, withBrowserCompile };
+export { CLAUDE_AGENT_SDK_SPECIFIER, CLAUDE_AGENT_SDK_VERSION, CLAUDE_CODE_LOGIN_CREDENTIAL, ClaudeAgentSdkMissingError, CompileComponentCodeError, DesignMode, EFFORT_DIALS, EFFORT_TABLE_VERSION, type EffortDials, HARNESS_CODING_TOOLS, HARNESS_SCOPED_TOOLS, type InLoopEvaluationSwitches, type UiGenBuild, compileComponentCode, createAnthropicClient, effortDials, ensureClaudeAgentSdk, generatorBuild, harnessToolEntry, harnessToolNames, inLoopEvaluation, runsInLoopEvaluation, withBrowserCompile };