veryfront 0.1.521 → 0.1.522

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.521",
+  "version": "0.1.522",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [
@@ -16,7 +16,7 @@ export default {
     "./extensions/ext-db-sqlite",
     "./extensions/ext-parser-babel",
     "./extensions/ext-sandbox-shell-tools",
-    "./extensions/ext-tracing-opentelemetry",
+    "./extensions/ext-observability-opentelemetry",
     "./extensions/ext-content-mdx",
     "./extensions/ext-schema-zod"
   ],
@@ -85,7 +85,7 @@ export default {
     "./extensions/parser": "./src/extensions/parser/index.ts",
     "./extensions/sandbox": "./src/extensions/sandbox/index.ts",
     "./extensions/schema": "./src/extensions/schema/index.ts",
-    "./extensions/tracing": "./src/extensions/tracing/index.ts",
+    "./extensions/observability": "./src/extensions/observability/index.ts",
     "./testing": "./src/testing/index.ts",
     "./testing/assert": "./src/testing/assert.ts",
     "./testing/bdd": "./src/testing/bdd.ts",
@@ -180,7 +180,7 @@ export default {
     "veryfront/extensions/parser": "./src/extensions/parser/index.ts",
     "veryfront/extensions/sandbox": "./src/extensions/sandbox/index.ts",
     "veryfront/extensions/schema": "./src/extensions/schema/index.ts",
-    "veryfront/extensions/tracing": "./src/extensions/tracing/index.ts",
+    "veryfront/extensions/observability": "./src/extensions/observability/index.ts",
     "#veryfront": "./src/index.ts",
     "#veryfront/agent": "./src/agent/index.ts",
     "#veryfront/agent/react": "./src/agent/react/index.ts",

package/src/extensions/{ext-tracing-opentelemetry → ext-observability-opentelemetry}/src/index.ts

@@ -1,18 +1,18 @@
 /**
- * ext-tracing-opentelemetry — TracingExporter implementation backed by the
+ * ext-observability-opentelemetry: OpenTelemetry observability extension backed by the
  * official OpenTelemetry JS SDK.
  *
  * Provides the `TracingExporter` and `NodeTelemetryProvider` contracts:
- *  - `start(config)` — builds the SDK provider + OTLP HTTP exporter
- *  - `export(spans)` — no-op (SDK handles export via BatchSpanProcessor)
- *  - `shutdown()` — flushes + shuts down the provider
- *  - `getProvider()` — returns the SDK TracerProvider for shim wiring
- *  - `initialize(options)` — starts NodeSDK auto-instrumentation
+ *  - `start(config)`: builds the SDK provider and OTLP HTTP exporter
+ *  - `export(spans)`: no-op, the SDK handles export via BatchSpanProcessor
+ *  - `shutdown()`: flushes and shuts down the provider
+ *  - `getProvider()`: returns the SDK TracerProvider for shim wiring
+ *  - `initialize(options)`: starts NodeSDK auto-instrumentation
  *
  * Configuration is read from `ctx.config` (see `OtlpExtConfig`) and falls
  * back to standard OTEL environment variables.
  *
- * @module extensions/ext-tracing-opentelemetry
+ * @module extensions/ext-observability-opentelemetry
  */
 import * as dntShim from "../../../_dnt.shims.js";
 
@@ -23,7 +23,7 @@ import type {
   NodeTelemetryProvider,
   SpanData,
   TracingExporter,
-} from "../../../src/extensions/tracing/index.js";
+} from "../../../src/extensions/observability/index.js";
 
 import { metrics, trace } from "@opentelemetry/api";
 import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node";
@@ -42,7 +42,7 @@ import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from "@opentelemetry/semantic
 
 /**
  * The TracerProvider interface as expected by the core shim.
- * Using structural typing — the real SDK provider satisfies this shape.
+ * Using structural typing because the real SDK provider satisfies this shape.
  */
 interface ShimTracerProvider {
   getTracer(name: string, version?: string): unknown;
@@ -247,7 +247,7 @@ class OpenTelemetryNodeTelemetryProvider implements NodeTelemetryProvider {
 }
 
 /**
- * Default export — the ext-tracing-opentelemetry extension factory.
+ * Default export for the ext-observability-opentelemetry extension factory.
  *
  * Produces an extension that registers a `TracingExporter` contract
  * implementation backed by the OpenTelemetry JS SDK.
@@ -257,7 +257,7 @@ const extOpenTelemetry: ExtensionFactory = () => {
   const nodeTelemetryProvider = new OpenTelemetryNodeTelemetryProvider();
 
   return {
-    name: "ext-tracing-opentelemetry",
+    name: "ext-observability-opentelemetry",
     version: "0.1.0",
     capabilities: [
       { type: "contract", name: "TracingExporter" },
@@ -277,7 +277,7 @@ const extOpenTelemetry: ExtensionFactory = () => {
       await exporterImpl.start(ctx.config);
       ctx.provide("TracingExporter", exporterImpl);
       ctx.provide("NodeTelemetryProvider", nodeTelemetryProvider);
-      ctx.logger.info("[ext-tracing-opentelemetry] TracingExporter registered");
+      ctx.logger.info("[ext-observability-opentelemetry] TracingExporter registered");
     },
     async teardown() {
       await nodeTelemetryProvider.shutdown();

package/src/src/agent/service/config.ts

@@ -1,3 +1,4 @@
+import { ensureBuiltinSchemaValidator } from "../../extensions/builtin-extensions.js";
 import { defineSchema } from "../../schemas/define.js";
 import { lazySchema } from "../../schemas/lazy.js";
 
@@ -95,6 +96,7 @@ export type HostedAgentServiceConfigInput = AgentServiceConfigInput;
 export function parseAgentServiceConfig(
   input: AgentServiceConfigInput,
 ): AgentServiceConfig {
+  ensureBuiltinSchemaValidator();
   return agentServiceConfigSchema.parse(input);
 }
 

package/src/src/agent/service/node-telemetry.ts

@@ -6,7 +6,7 @@ import {
   type NodeTelemetryProcessTarget,
   type NodeTelemetryProvider,
   NodeTelemetryProviderName,
-} from "../../extensions/tracing/index.js";
+} from "../../extensions/observability/index.js";
 
 export type NodeHostedAgentServiceTelemetryEnv = Record<string, string | undefined>;
 

package/src/src/agent/veryfront-cloud-agent-service.ts

@@ -11,7 +11,7 @@ import type { SchemaValidator } from "../extensions/schema/index.js";
 import {
   type NodeTelemetryProvider,
   NodeTelemetryProviderName,
-} from "../extensions/tracing/index.js";
+} from "../extensions/observability/index.js";
 import {
   type SandboxShellToolsProvider,
   SandboxShellToolsProviderName,
@@ -379,7 +379,7 @@ async function ensureDefaultAuthProvider(): Promise<void> {
 async function ensureDefaultNodeTelemetryProvider(): Promise<void> {
   if (tryResolve<NodeTelemetryProvider>(NodeTelemetryProviderName)) return;
   const { OpenTelemetryNodeTelemetryProvider } = await import(
-    "../../extensions/ext-tracing-opentelemetry/src/index.js"
+    "../../extensions/ext-observability-opentelemetry/src/index.js"
   );
   register<NodeTelemetryProvider>(
     NodeTelemetryProviderName,

package/src/src/extensions/{tracing → observability}/index.ts

@@ -1,7 +1,7 @@
 /**
- * Tracing category barrel: tracing and Node telemetry contracts.
+ * Observability category barrel: tracing and Node telemetry contracts.
  *
- * @module extensions/tracing
+ * @module extensions/observability
  */
 import "../../../_dnt.polyfills.js";
 

package/src/src/extensions/{tracing → observability}/node-telemetry-provider.ts

@@ -1,9 +1,9 @@
 /**
  * Contract interface for Node.js OpenTelemetry runtime bootstrap.
  *
- * Default implementation: `@veryfront/ext-tracing-opentelemetry`
+ * Default implementation: `@veryfront/ext-observability-opentelemetry`
  *
- * @module extensions/tracing/node-telemetry-provider
+ * @module extensions/observability/node-telemetry-provider
  */
 
 export const NodeTelemetryProviderName = "NodeTelemetryProvider";

package/src/src/extensions/{tracing → observability}/tracing-exporter.ts

@@ -1,9 +1,9 @@
 /**
  * Contract interface for tracing/telemetry exporters.
  *
- * Default implementation: `@veryfront/ext-tracing-opentelemetry`
+ * Default implementation: `@veryfront/ext-observability-opentelemetry`
  *
- * @module extensions/tracing/tracing-exporter
+ * @module extensions/observability/tracing-exporter
  */
 
 /**

package/src/src/extensions/recommendations.ts

@@ -14,8 +14,8 @@ const recommendations = new Map<string, string>([
   ["ContentProcessor", "@veryfront/ext-content-mdx"],
   ["DocumentExtractor", "@veryfront/ext-document-kreuzberg"],
   ["AuthProvider", "@veryfront/ext-auth-jwt"],
-  ["TracingExporter", "@veryfront/ext-tracing-opentelemetry"],
-  ["NodeTelemetryProvider", "@veryfront/ext-tracing-opentelemetry"],
+  ["TracingExporter", "@veryfront/ext-observability-opentelemetry"],
+  ["NodeTelemetryProvider", "@veryfront/ext-observability-opentelemetry"],
   ["LLMProvider:openai", "@veryfront/ext-llm-openai"],
   ["LLMProvider:anthropic", "@veryfront/ext-llm-anthropic"],
   ["LLMProvider:google", "@veryfront/ext-llm-google"],

package/src/src/observability/metrics/manager.ts

@@ -80,7 +80,7 @@ export class MetricsManager {
     }
 
     try {
-      // The metrics API is injected by ext-tracing-opentelemetry via setGlobalMetricsAPI().
+      // The metrics API is injected by ext-observability-opentelemetry via setGlobalMetricsAPI().
       // When the extension is not active, metrics collection is disabled.
       const metricsApi = getGlobalMetricsAPI();
       if (!metricsApi) {

package/src/src/observability/simple-metrics/otel-instruments.ts

@@ -27,7 +27,7 @@ export async function ensureOtelInstruments(): Promise<void> {
   if (!isDeno) return;
 
   try {
-    // The metrics API is injected by ext-tracing-opentelemetry via setGlobalMetricsAPI().
+    // The metrics API is injected by ext-observability-opentelemetry via setGlobalMetricsAPI().
     // When the extension is not active, the meter is unavailable and we return.
     const metricsApi = getGlobalMetricsAPI();
     if (!metricsApi) return;

package/src/src/observability/tracing/api-shim.ts

@@ -2,7 +2,7 @@
  * Thin in-process shim for `@opentelemetry/api`.
  *
  * Core files that previously imported directly from `@opentelemetry/api` now
- * import from this module.  When the `ext-tracing-opentelemetry` extension is present
+ * import from this module.  When the `ext-observability-opentelemetry` extension is present
  * the real SDK provider is wired in via `setGlobalTracerProvider`; otherwise
  * every call falls back to a no-op implementation so the core boots without the
  * extension installed.
@@ -172,7 +172,7 @@ export interface MetricsAPI {
 }
 
 // ---------------------------------------------------------------------------
-// No-op provider (default when ext-tracing-opentelemetry is not installed)
+// No-op provider (default when ext-observability-opentelemetry is not installed)
 // ---------------------------------------------------------------------------
 
 function createNoopContext(): Context {
@@ -254,7 +254,7 @@ let _propagator: TextMapPropagator | null = null;
 
 /**
  * Optional accessor for the currently active span. Wired by
- * ext-tracing-opentelemetry (via `setGlobalActiveSpanAccessor`) so `trace.getActiveSpan()`
+ * ext-observability-opentelemetry (via `setGlobalActiveSpanAccessor`) so `trace.getActiveSpan()`
  * and `trace.getSpan()` return the real SDK span once the extension is active.
  */
 let _activeSpanAccessor: {
@@ -264,7 +264,7 @@ let _activeSpanAccessor: {
 
 /**
  * Register the real OTel trace API's span accessors. Called by the
- * ext-tracing-opentelemetry extension after it wires the SDK so that the shim's
+ * ext-observability-opentelemetry extension after it wires the SDK so that the shim's
  * `trace.getActiveSpan()` / `trace.getSpan()` can return real spans.
  */
 export function setGlobalActiveSpanAccessor(
@@ -287,7 +287,7 @@ export function getGlobalTracerProvider(): TracerProvider {
 
 /**
  * Get a tracer from the active provider.
- * Returns the no-op tracer when ext-tracing-opentelemetry is not installed.
+ * Returns the no-op tracer when ext-observability-opentelemetry is not installed.
  */
 export function getTracer(name: string, version?: string): Tracer {
   return _provider.getTracer(name, version);
@@ -378,14 +378,14 @@ export const defaultTextMapSetter: TextMapSetter<Record<string, string>> = {
 };
 
 // ---------------------------------------------------------------------------
-// Metrics API registry (injected by ext-tracing-opentelemetry when active)
+// Metrics API registry (injected by ext-observability-opentelemetry when active)
 // ---------------------------------------------------------------------------
 
 let _metricsApi: MetricsAPI | null = null;
 
 /**
  * Register the OTel Metrics API (from the SDK).
- * Called by ext-tracing-opentelemetry in its setup hook so the metrics subsystem
+ * Called by ext-observability-opentelemetry in its setup hook so the metrics subsystem
  * can use `getMeter()` when available.
  */
 export function setGlobalMetricsAPI(api: MetricsAPI): void {

package/src/src/observability/tracing/manager.ts

@@ -56,7 +56,7 @@ export class TracingManager {
   }
 
   private async initializeTracer(config: TracingConfig): Promise<void> {
-    // Use the shim API — delegates to the real SDK when ext-tracing-opentelemetry is wired.
+    // Use the shim API — delegates to the real SDK when ext-observability-opentelemetry is wired.
     const shimApi = await import("./api-shim.js");
     const api: OpenTelemetryAPI = {
       trace: {
@@ -79,7 +79,7 @@ export class TracingManager {
 
     this.state.tracer = api.trace.getTracer(config.serviceName ?? "veryfront", VERSION);
 
-    // No-op propagator used only when ext-tracing-opentelemetry is NOT installed.
+    // No-op propagator used only when ext-observability-opentelemetry is NOT installed.
     // When the extension is active, it registers W3CTraceContextPropagator
     // on the shim directly; we intentionally do NOT wrap shimApi.propagation
     // here (doing so would cause infinite recursion when the global

package/src/src/observability/tracing/otlp-setup.ts

@@ -1,7 +1,7 @@
 /**************************
  * OpenTelemetry OTLP Setup
  *
- * Thin wrapper that delegates to the `ext-tracing-opentelemetry` extension via the
+ * Thin wrapper that delegates to the `ext-observability-opentelemetry` extension via the
  * `TracingExporter` contract.  When the extension is not installed, all span
  * operations silently no-op.
  *
@@ -81,15 +81,15 @@ export async function initializeOTLP(): Promise<void> {
     logger.debug("Already initialized");
     return;
   }
-  // Actual provider setup is handled by ext-tracing-opentelemetry via bootstrap.
+  // Actual provider setup is handled by ext-observability-opentelemetry via bootstrap.
   // This is kept for backward compatibility.
   initialized = true;
-  logger.debug("OTLP setup delegated to ext-tracing-opentelemetry extension");
+  logger.debug("OTLP setup delegated to ext-observability-opentelemetry extension");
 }
 
 export async function shutdownOTLP(): Promise<void> {
   // Actual shutdown is handled by the extension loader teardown.
-  logger.debug("OTLP shutdown delegated to ext-tracing-opentelemetry extension");
+  logger.debug("OTLP shutdown delegated to ext-observability-opentelemetry extension");
 }
 
 export function isOTLPEnabled(): boolean {

package/src/src/proxy/tracing.ts

@@ -1,7 +1,7 @@
 /****
  * OpenTelemetry OTLP tracing for proxy.
  *
- * Uses the core api-shim for in-process tracing; when ext-tracing-opentelemetry
+ * Uses the core api-shim for in-process tracing; when ext-observability-opentelemetry
  * is loaded, the shim delegates to the real SDK provider.
  *
  * Env: OTEL_TRACES_ENABLED, OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT,
@@ -71,7 +71,7 @@ export async function initializeOTLPWithApis(): Promise<void> {
   }
 
   try {
-    // The shim's provider is wired by ext-tracing-opentelemetry via bootstrap.ts.
+    // The shim's provider is wired by ext-observability-opentelemetry via bootstrap.ts.
     // We simply get a tracer from the shim — it delegates to the real SDK
     // when the extension is active, otherwise returns the no-op tracer.
     tracer = shimTrace.getTracer(config.serviceName);

package/src/src/react/components/chat/theme.ts

@@ -247,8 +247,10 @@ function variantClasses<TVariants extends VariantMap>(
     const classes: ClassValue[] = [base];
 
     for (const [variantName, variantValues] of Object.entries(config.variants)) {
-      const selected = options[variantName] ??
-        config.defaultVariants?.[variantName];
+      const option = options[variantName];
+      const selected = Object.hasOwn(options, variantName) && option !== undefined
+        ? option
+        : config.defaultVariants?.[variantName];
       if (selected === null || selected === undefined) continue;
       classes.push(variantValues[String(selected)]);
     }

package/src/src/server/bootstrap.ts

@@ -13,7 +13,7 @@ import {
 } from "../extensions/builtin-extensions.js";
 import { MISSING_EXTENSION_ERROR } from "../extensions/errors.js";
 import { getRecommendation } from "../extensions/recommendations.js";
-import type { TracingExporter } from "../extensions/tracing/tracing-exporter.js";
+import type { TracingExporter } from "../extensions/observability/tracing-exporter.js";
 import {
   setGlobalActiveSpanAccessor,
   setGlobalMetricsAPI,