veryfront 0.1.246 → 0.1.248

package/esm/src/observability/tracing/otlp-setup.js

@@ -1,21 +1,20 @@
 /**************************
- * OpenTelemetry OTLP Setup for Grafana Cloud
+ * OpenTelemetry OTLP Setup
+ *
+ * Thin wrapper that delegates to the `ext-opentelemetry` extension via the
+ * `TracingExporter` contract.  When the extension is not installed, all span
+ * operations silently no-op.
  *
- * Configures the OTLP exporter to send traces to Grafana Cloud.
  * Reads configuration from environment variables:
  * - OTEL_TRACES_ENABLED: "true" to enable tracing
  * - OTEL_SERVICE_NAME: Service name for traces
- * - OTEL_EXPORTER_OTLP_ENDPOINT: OTLP endpoint (e.g., https://otlp-gateway-prod-eu-west-2.grafana.net/otlp)
- * - OTEL_EXPORTER_OTLP_HEADERS: Auth headers (e.g., Authorization=Basic ...)
+ * - OTEL_EXPORTER_OTLP_ENDPOINT: OTLP endpoint
+ * - OTEL_EXPORTER_OTLP_HEADERS: Auth headers
  **************************/
 import { getOtelTracingConfig } from "../../config/env.js";
 import { serverLogger } from "../../utils/index.js";
-import { RUNTIME_VERSION } from "../../utils/version.js";
+import { context as shimContext, defaultTextMapGetter, defaultTextMapSetter, getTracer, propagation as shimPropagation, SpanKind, SpanStatusCode, trace as shimTrace, } from "./api-shim.js";
 const logger = serverLogger.component("otel");
-let initialized = false;
-let tracerProvider = null;
-let traceApi = null;
-let propagationApi = null;
 function parseHeaders(headerString) {
     if (!headerString)
         return {};
@@ -42,107 +41,50 @@ function getConfig() {
         headers: parseHeaders(tracingConfig.headers),
     };
 }
-async function ensureApis() {
-    if (traceApi && propagationApi)
-        return;
-    traceApi = await import("@opentelemetry/api");
-    propagationApi = await import("@opentelemetry/core");
-}
-function setSpanErrorStatus(span, error) {
-    if (!traceApi)
-        return;
-    span.setStatus({
-        code: traceApi.SpanStatusCode.ERROR,
-        message: error instanceof Error ? error.message : String(error),
-    });
-    if (error instanceof Error)
-        span.recordException(error);
-}
+// ---------------------------------------------------------------------------
+// Legacy initialise / shutdown (now delegated to bootstrap.ts + ext)
+// ---------------------------------------------------------------------------
+let initialized = false;
 export async function initializeOTLP() {
     if (initialized) {
         logger.debug("Already initialized");
         return;
     }
-    const config = getConfig();
-    if (!config.enabled) {
-        logger.debug("Tracing disabled (OTEL_TRACES_ENABLED != true)");
-        initialized = true;
-        return;
-    }
-    if (!config.endpoint) {
-        logger.warn("No OTEL_EXPORTER_OTLP_ENDPOINT configured, skipping");
-        initialized = true;
-        return;
-    }
-    try {
-        const { BasicTracerProvider, BatchSpanProcessor } = await import("@opentelemetry/sdk-trace-base");
-        const { OTLPTraceExporter } = await import("@opentelemetry/exporter-trace-otlp-http");
-        const { resourceFromAttributes } = await import("@opentelemetry/resources");
-        const { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } = await import("@opentelemetry/semantic-conventions");
-        const { AsyncLocalStorageContextManager } = await import("@opentelemetry/context-async-hooks");
-        const resource = resourceFromAttributes({
-            [ATTR_SERVICE_NAME]: config.serviceName,
-            [ATTR_SERVICE_VERSION]: RUNTIME_VERSION,
-        });
-        const endpointBase = config.endpoint.replace(/\/$/, "");
-        const exporter = new OTLPTraceExporter({
-            url: `${endpointBase}/v1/traces`,
-            headers: config.headers,
-        });
-        const contextManager = new AsyncLocalStorageContextManager();
-        contextManager.enable();
-        const provider = new BasicTracerProvider({
-            resource,
-            spanProcessors: [new BatchSpanProcessor(exporter)],
-        });
-        // In OTel SDK v2, provider.register() is removed.
-        // Set global tracer provider and context manager via the API directly.
-        traceApi = await import("@opentelemetry/api");
-        traceApi.trace.setGlobalTracerProvider(provider);
-        traceApi.context.setGlobalContextManager(contextManager);
-        tracerProvider = provider;
-        initialized = true;
-        logger.info("OpenTelemetry OTLP tracing initialized", {
-            serviceName: config.serviceName,
-            endpoint: config.endpoint,
-        });
-        traceApi.trace.getTracer(config.serviceName);
-        logger.debug("Tracer obtained", { name: config.serviceName });
-        // Bridge trace context into the logger so every JSON log entry
-        // automatically includes traceId/spanId from the active span.
-        // Imported here (rather than per-entrypoint) so all callers of
-        // initializeOTLP benefit — CLI serve, production-server, proxy, etc.
-        await import("../../utils/logger/trace-bridge.js");
-    }
-    catch (error) {
-        logger.error("Failed to initialize OTLP tracing", { error });
-        initialized = true; // Mark as initialized to prevent retries
-    }
+    // Actual provider setup is handled by ext-opentelemetry via bootstrap.
+    // This is kept for backward compatibility.
+    initialized = true;
+    logger.debug("OTLP setup delegated to ext-opentelemetry extension");
 }
 export async function shutdownOTLP() {
-    if (!tracerProvider)
-        return;
-    try {
-        await tracerProvider.shutdown();
-        logger.info("Tracer provider shutdown complete");
-    }
-    catch (error) {
-        logger.warn("Error during tracer shutdown", { error });
-    }
+    // Actual shutdown is handled by the extension loader teardown.
+    logger.debug("OTLP shutdown delegated to ext-opentelemetry extension");
 }
 export function isOTLPEnabled() {
-    return initialized && tracerProvider !== null;
+    return initialized;
+}
+export async function initializeOTLPWithApis() {
+    await initializeOTLP();
+}
+// ---------------------------------------------------------------------------
+// Span helpers — delegate to shim (which delegates to SDK if wired)
+// ---------------------------------------------------------------------------
+function setSpanErrorStatus(span, error) {
+    span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: error instanceof Error ? error.message : String(error),
+    });
+    if (error instanceof Error)
+        span.recordException(error);
 }
 export async function withSpan(name, fn, attributes) {
-    if (!traceApi || !isOTLPEnabled())
-        return fn();
-    const tracer = traceApi.trace.getTracer(getConfig().serviceName);
-    const parentContext = traceApi.context.active();
-    const span = tracer.startSpan(name, { kind: traceApi.SpanKind.INTERNAL, attributes }, parentContext);
-    const spanContext = traceApi.trace.setSpan(parentContext, span);
+    const config = getConfig();
+    const tracer = getTracer(config.serviceName);
+    const parentContext = shimContext.active();
+    const span = tracer.startSpan(name, { kind: SpanKind.INTERNAL, attributes }, parentContext);
+    const spanContext = shimTrace.setSpan(parentContext, span);
     try {
-        const result = await traceApi.context.with(spanContext, fn);
-        span.setStatus({ code: traceApi.SpanStatusCode.OK });
+        const result = await shimContext.with(spanContext, fn);
+        span.setStatus({ code: SpanStatusCode.OK });
         return result;
     }
     catch (error) {
@@ -154,14 +96,13 @@ export async function withSpan(name, fn, attributes) {
     }
 }
 export function withSpanSync(name, fn, attributes) {
-    if (!traceApi || !isOTLPEnabled())
-        return fn();
-    const tracer = traceApi.trace.getTracer(getConfig().serviceName);
-    const parentContext = traceApi.context.active();
-    const span = tracer.startSpan(name, { kind: traceApi.SpanKind.INTERNAL, attributes }, parentContext);
+    const config = getConfig();
+    const tracer = getTracer(config.serviceName);
+    const parentContext = shimContext.active();
+    const span = tracer.startSpan(name, { kind: SpanKind.INTERNAL, attributes }, parentContext);
     try {
         const result = fn();
-        span.setStatus({ code: traceApi.SpanStatusCode.OK });
+        span.setStatus({ code: SpanStatusCode.OK });
         return result;
     }
     catch (error) {
@@ -173,35 +114,28 @@ export function withSpanSync(name, fn, attributes) {
     }
 }
 export function extractContext(headers) {
-    if (!traceApi || !propagationApi)
-        return traceApi?.context?.active();
     const carrier = {};
     for (const [k, v] of headers)
         carrier[k.toLowerCase()] = v;
-    if (!propagationApi.W3CTraceContextPropagator)
-        return traceApi.context.active();
-    return new propagationApi.W3CTraceContextPropagator().extract(traceApi.context.active(), carrier, traceApi.defaultTextMapGetter);
+    return shimPropagation.extract(shimContext.active(), carrier, defaultTextMapGetter);
 }
 export function injectContext(headers) {
-    if (!traceApi || !propagationApi)
-        return;
     const carrier = {};
-    new propagationApi.W3CTraceContextPropagator().inject(traceApi.context.active(), carrier, traceApi.defaultTextMapSetter);
+    shimPropagation.inject(shimContext.active(), carrier, defaultTextMapSetter);
     for (const [k, v] of Object.entries(carrier))
         headers.set(k, v);
 }
 export function startServerSpan(method, path, parentContext) {
-    if (!traceApi || !isOTLPEnabled())
-        return null;
-    const tracer = traceApi.trace.getTracer(getConfig().serviceName);
-    const ctx = (parentContext || traceApi.context.active());
-    const span = tracer.startSpan(`${method} ${path}`, { kind: traceApi.SpanKind.SERVER }, ctx);
+    const config = getConfig();
+    const tracer = getTracer(config.serviceName);
+    const ctx = (parentContext || shimContext.active());
+    const span = tracer.startSpan(`${method} ${path}`, { kind: SpanKind.SERVER }, ctx);
     span.setAttribute("http.method", method);
     span.setAttribute("http.target", path);
-    return { span, context: traceApi.trace.setSpan(ctx, span) };
+    return { span, context: shimTrace.setSpan(ctx, span) };
 }
 export function endServerSpan(span, statusCode, error) {
-    if (!span || !traceApi)
+    if (!span)
         return;
     const otelSpan = span;
     otelSpan.setAttribute("http.status_code", statusCode);
@@ -211,45 +145,34 @@ export function endServerSpan(span, statusCode, error) {
         return;
     }
     if (statusCode >= 400) {
-        otelSpan.setStatus({ code: traceApi.SpanStatusCode.ERROR });
+        otelSpan.setStatus({ code: SpanStatusCode.ERROR });
         otelSpan.end();
         return;
     }
-    otelSpan.setStatus({ code: traceApi.SpanStatusCode.OK });
+    otelSpan.setStatus({ code: SpanStatusCode.OK });
     otelSpan.end();
 }
 export function setSpanAttributes(span, attributes) {
-    if (!span || !traceApi)
+    if (!span)
         return;
     const otelSpan = span;
     for (const [key, value] of Object.entries(attributes))
         otelSpan.setAttribute(key, value);
 }
 export function setActiveSpanAttributes(attributes) {
-    if (!traceApi)
-        return;
-    const span = traceApi.trace.getSpan(traceApi.context.active());
+    const span = shimTrace.getActiveSpan?.();
     if (!span)
         return;
     for (const [key, value] of Object.entries(attributes))
         span.setAttribute(key, value);
 }
 export async function withContext(spanContext, fn) {
-    if (!traceApi)
-        return fn();
-    return traceApi.context.with(spanContext, fn);
+    return shimContext.with(spanContext, fn);
 }
 export function getTraceContext() {
-    if (!traceApi)
-        return {};
-    const span = traceApi.trace.getSpan(traceApi.context.active());
+    const span = shimTrace.getActiveSpan?.();
     if (!span)
         return {};
     const ctx = span.spanContext();
     return { traceId: ctx.traceId, spanId: ctx.spanId };
 }
-export async function initializeOTLPWithApis() {
-    await initializeOTLP();
-    if (isOTLPEnabled())
-        await ensureApis();
-}

package/esm/src/observability/tracing/types.d.ts

@@ -1,4 +1,4 @@
-import type { Context, Span, SpanKind, TextMapPropagator, Tracer } from "@opentelemetry/api";
+import type { Context, Span, SpanKind, TextMapPropagator, Tracer } from "./api-shim.js";
 export interface TracingConfig {
     enabled: boolean;
     exporter: "jaeger" | "zipkin" | "otlp" | "console";

package/esm/src/observability/tracing/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/src/observability/tracing/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE7F,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACvD,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE;QACL,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC9D,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;KAChD,CAAC;IACF,WAAW,EAAE;QACX,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;QACzD,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;QACpE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;KACjE,CAAC;IACF,OAAO,EAAE;QACP,MAAM,IAAI,OAAO,CAAC;QAClB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;KAC3C,CAAC;IACF,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,cAAc,EAAE;QACd,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACtC;AAED,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/src/observability/tracing/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAExF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACvD,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE;QACL,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC9D,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;KAChD,CAAC;IACF,WAAW,EAAE;QACX,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;QACzD,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;QACpE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;KACjE,CAAC;IACF,OAAO,EAAE;QACP,MAAM,IAAI,OAAO,CAAC;QAClB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;KAC3C,CAAC;IACF,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,cAAc,EAAE;QACd,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACtC;AAED,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC"}

package/esm/src/platform/compat/kv/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/kv/factory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAQrC,wBAAsB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,CAuBvD;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAEtE;AAED,wBAAgB,cAAc,IAAI,IAAI,CAMrC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/kv/factory.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,EAAE,EAAkB,MAAM,YAAY,CAAC;AASrD,wBAAsB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,CAgCvD;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAEtE;AAED,wBAAgB,cAAc,IAAI,IAAI,CAMrC"}

package/esm/src/platform/compat/kv/factory.js

@@ -1,4 +1,5 @@
 import * as dntShim from "../../../../_dnt.shims.js";
+import { tryResolve } from "../../../extensions/contracts.js";
 import { serverLogger } from "../../../utils/index.js";
 import { isDeno } from "../runtime.js";
 import { MemoryKv } from "./memory-adapter.js";
@@ -16,13 +17,21 @@ export async function openKv(path) {
             }
         }
     }
-    try {
-        const Database = (await import("better-sqlite3")).default;
-        const db = new Database(path ?? ":memory:");
-        return new SqliteKv(db);
+    const nodeCompat = tryResolve("NodeCompat");
+    if (nodeCompat?.openSqliteDatabase) {
+        try {
+            const db = await nodeCompat.openSqliteDatabase(path);
+            // NodeCompatSqliteDatabase is structurally identical to SqliteDatabase;
+            // cast to satisfy the SqliteKv constructor's nominal type check.
+            return new SqliteKv(db);
+        }
+        catch (error) {
+            serverLogger.debug("NodeCompat.openSqliteDatabase failed, using memory KV:", error);
+        }
     }
-    catch (error) {
-        serverLogger.debug("SQLite not available, using memory KV:", error);
+    else {
+        serverLogger.debug("NodeCompat extension not registered — SQLite KV unavailable. " +
+            "Install @veryfront/ext-node-compat to enable SQLite-backed KV.");
     }
     return new MemoryKv();
 }

package/esm/src/platform/compat/opaque-deps.d.ts

@@ -6,11 +6,12 @@ export declare function importClaudeAgentSDK(): Promise<OpaqueModule>;
 /**
  * Lazily import kreuzberg document extraction.
  *
- * Unlike the other opaque deps above, kreuzberg is a core framework
- * dependency that must work in compiled binaries. The Deno path uses
- * a regular `import()` (not `dynamicImport`) so `deno compile` can
- * trace and embed `@kreuzberg/wasm`. The Node/Bun path uses `dynamicImport`
- * to resolve `@kreuzberg/node` from the project's node_modules at runtime.
+ * Delegates to the `NodeCompat` extension contract (`@veryfront/ext-node-compat`)
+ * when available. Without the extension, throws an actionable error instructing
+ * the user to install `ext-node-compat`.
+ *
+ * Node/Bun path: `@kreuzberg/node` resolved from the project's node_modules at
+ * runtime — the extension handles that dynamic import internally.
  */
 export declare function importKreuzberg(): Promise<{
     extractBytes: (data: Uint8Array, mimeType: string) => Promise<{

package/esm/src/platform/compat/opaque-deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opaque-deps.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/opaque-deps.ts"],"names":[],"mappings":"AA2BA,KAAK,YAAY,GAAG,GAAG,CAAC;AAUxB,yEAAyE;AACzE,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CAE1D;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,IAAI,OAAO,CAAC,YAAY,CAAC,CAK5D;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAC/C,YAAY,EAAE,CACZ,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnC,CAAC,CAgCD"}
+{"version":3,"file":"opaque-deps.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/opaque-deps.ts"],"names":[],"mappings":"AA6BA,KAAK,YAAY,GAAG,GAAG,CAAC;AAExB,yEAAyE;AACzE,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CAE1D;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,IAAI,OAAO,CAAC,YAAY,CAAC,CAK5D;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAC/C,YAAY,EAAE,CACZ,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnC,CAAC,CASD"}

package/esm/src/platform/compat/opaque-deps.js

@@ -15,7 +15,8 @@
  * @module platform/compat
  */
 import * as dntShim from "../../../_dnt.shims.js";
-import { isDeno, isDenoCompiled } from "./runtime.js";
+import { tryResolve } from "../../extensions/contracts.js";
+import { isDeno } from "./runtime.js";
 import { dynamicImport } from "./dynamic-import.js";
 function resolve(pkg, version) {
     return isDeno ? `npm:${pkg}@${version}` : pkg;
@@ -35,43 +36,18 @@ export function importClaudeAgentSDK() {
 /**
  * Lazily import kreuzberg document extraction.
  *
- * Unlike the other opaque deps above, kreuzberg is a core framework
- * dependency that must work in compiled binaries. The Deno path uses
- * a regular `import()` (not `dynamicImport`) so `deno compile` can
- * trace and embed `@kreuzberg/wasm`. The Node/Bun path uses `dynamicImport`
- * to resolve `@kreuzberg/node` from the project's node_modules at runtime.
+ * Delegates to the `NodeCompat` extension contract (`@veryfront/ext-node-compat`)
+ * when available. Without the extension, throws an actionable error instructing
+ * the user to install `ext-node-compat`.
+ *
+ * Node/Bun path: `@kreuzberg/node` resolved from the project's node_modules at
+ * runtime — the extension handles that dynamic import internally.
  */
 export async function importKreuzberg() {
-    if (isDeno) {
-        // Regular import — visible to deno compile, resolved via deno.json import map
-        const mod = await import("@kreuzberg/wasm");
-        if (isDenoCompiled) {
-            // Kreuzberg's initWasm() internally uses a computed dynamic import() to
-            // load the WASM glue module (kreuzberg_wasm.js). deno compile cannot
-            // trace computed import() paths, so the glue module is absent from the
-            // binary's embedded module graph. Pre-importing it here populates Deno's
-            // in-process module cache so the subsequent import() inside initWasm()
-            // resolves from cache instead of hitting the missing file.
-            await import("@kreuzberg/wasm/dist/pkg/kreuzberg_wasm.js");
-            // pdfium.js is not in @kreuzberg/wasm package exports, so we can't use
-            // an import map entry. Resolve its URL relative to the kreuzberg package
-            // and pre-import it so initWasm()'s `import("./pdfium.js")` resolves
-            // from the in-process module cache instead of hanging.
-            // Wrapped in try/catch because pdfium is only needed for PDF extraction;
-            // a failure here should not break extraction of other formats (DOCX, etc.).
-            try {
-                const kreuzbergUrl = globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).resolve("@kreuzberg/wasm");
-                await import(new URL("./pdfium.js", kreuzbergUrl).href);
-            }
-            catch {
-                // expected: pdfium pre-import may fail if the file is missing or
-                // the package structure changed — PDF extraction will be degraded
-                // but other formats will still work.
-            }
-        }
-        await mod.initWasm?.();
-        return mod;
+    const nodeCompat = tryResolve("NodeCompat");
+    if (nodeCompat?.importKreuzberg) {
+        return nodeCompat.importKreuzberg();
     }
-    // Opaque import — resolved from node_modules at runtime
-    return dynamicImport("@kreuzberg/node");
+    throw new Error("Document extraction requires the NodeCompat extension. " +
+        "Install @veryfront/ext-node-compat and add it to your extensions configuration.");
 }

package/esm/src/proxy/tracing.d.ts

@@ -1,8 +1,13 @@
 /****
  * OpenTelemetry OTLP tracing for proxy.
- * Env: OTEL_TRACES_ENABLED, OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_HEADERS
+ *
+ * Uses the core api-shim for in-process tracing; when ext-opentelemetry
+ * is loaded, the shim delegates to the real SDK provider.
+ *
+ * Env: OTEL_TRACES_ENABLED, OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT,
+ *      OTEL_EXPORTER_OTLP_HEADERS
  */
-import type { Context, Span } from "@opentelemetry/api";
+import { type Context, type Span } from "../observability/tracing/api-shim.js";
 export declare function initializeOTLPWithApis(): Promise<void>;
 export declare function shutdownOTLP(): Promise<void>;
 export declare function extractContext(headers: Headers): Context | undefined;

package/esm/src/proxy/tracing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/src/proxy/tracing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAU,MAAM,oBAAoB,CAAC;AA6DhE,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CA6D5D;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CASlD;AAOD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAgBpE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgBpD;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,OAAO,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAMzC;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAiBvF;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAGrF;AAWD,wBAAgB,eAAe,IAAI;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAIvE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,OAAO,CAAC,CAAC,CAAC,CA0BZ"}
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/src/proxy/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,OAAO,EAKZ,KAAK,IAAI,EAKV,MAAM,sCAAsC,CAAC;AAmC9C,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CA+B5D;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAQpE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAOpD;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,OAAO,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAMzC;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAiBvF;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAErF;AAOD,wBAAgB,eAAe,IAAI;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAIvE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,OAAO,CAAC,CAAC,CAAC,CA0BZ"}