@databricks/appkit 0.69.3 → 0.71.0

package/dist/shared/src/schemas/manifest.d.ts

@@ -12,12 +12,12 @@ declare const resourceFieldEntrySchema: z.ZodObject<{
   discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"kind">;
     resourceKind: z.ZodEnum<{
-      volume: "volume";
       warehouse: "warehouse";
       genie_space: "genie_space";
       postgres_project: "postgres_project";
       postgres_branch: "postgres_branch";
       postgres_database: "postgres_database";
+      volume: "volume";
     }>;
     select: z.ZodOptional<z.ZodString>;
     display: z.ZodOptional<z.ZodString>;
@@ -58,12 +58,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -99,12 +99,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -139,12 +139,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -162,9 +162,9 @@ declare const pluginManifestSchema: z.ZodObject<{
       type: z.ZodLiteral<"sql_warehouse">;
     }, z.core.$strict>, z.ZodObject<{
       permission: z.ZodEnum<{
-        CAN_QUERY: "CAN_QUERY";
         CAN_VIEW: "CAN_VIEW";
         CAN_MANAGE: "CAN_MANAGE";
+        CAN_QUERY: "CAN_QUERY";
       }>;
       alias: z.ZodString;
       resourceKey: z.ZodString;
@@ -180,12 +180,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -220,12 +220,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -259,12 +259,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -298,12 +298,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -337,12 +337,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -376,12 +376,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -415,12 +415,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -438,10 +438,10 @@ declare const pluginManifestSchema: z.ZodObject<{
       type: z.ZodLiteral<"postgres">;
     }, z.core.$strict>, z.ZodObject<{
       permission: z.ZodEnum<{
-        CAN_EDIT: "CAN_EDIT";
         CAN_VIEW: "CAN_VIEW";
         CAN_MANAGE: "CAN_MANAGE";
         CAN_RUN: "CAN_RUN";
+        CAN_EDIT: "CAN_EDIT";
       }>;
       alias: z.ZodString;
       resourceKey: z.ZodString;
@@ -457,12 +457,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -480,8 +480,8 @@ declare const pluginManifestSchema: z.ZodObject<{
       type: z.ZodLiteral<"genie_space">;
     }, z.core.$strict>, z.ZodObject<{
       permission: z.ZodEnum<{
-        CAN_EDIT: "CAN_EDIT";
         CAN_MANAGE: "CAN_MANAGE";
+        CAN_EDIT: "CAN_EDIT";
         CAN_READ: "CAN_READ";
       }>;
       alias: z.ZodString;
@@ -498,12 +498,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -537,12 +537,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -579,12 +579,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -620,12 +620,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -660,12 +660,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -683,9 +683,9 @@ declare const pluginManifestSchema: z.ZodObject<{
       type: z.ZodLiteral<"sql_warehouse">;
     }, z.core.$strict>, z.ZodObject<{
       permission: z.ZodEnum<{
-        CAN_QUERY: "CAN_QUERY";
         CAN_VIEW: "CAN_VIEW";
         CAN_MANAGE: "CAN_MANAGE";
+        CAN_QUERY: "CAN_QUERY";
       }>;
       alias: z.ZodString;
       resourceKey: z.ZodString;
@@ -701,12 +701,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -741,12 +741,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -780,12 +780,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -819,12 +819,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -858,12 +858,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -897,12 +897,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -936,12 +936,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -959,10 +959,10 @@ declare const pluginManifestSchema: z.ZodObject<{
       type: z.ZodLiteral<"postgres">;
     }, z.core.$strict>, z.ZodObject<{
       permission: z.ZodEnum<{
-        CAN_EDIT: "CAN_EDIT";
         CAN_VIEW: "CAN_VIEW";
         CAN_MANAGE: "CAN_MANAGE";
         CAN_RUN: "CAN_RUN";
+        CAN_EDIT: "CAN_EDIT";
       }>;
       alias: z.ZodString;
       resourceKey: z.ZodString;
@@ -978,12 +978,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -1001,8 +1001,8 @@ declare const pluginManifestSchema: z.ZodObject<{
       type: z.ZodLiteral<"genie_space">;
     }, z.core.$strict>, z.ZodObject<{
       permission: z.ZodEnum<{
-        CAN_EDIT: "CAN_EDIT";
         CAN_MANAGE: "CAN_MANAGE";
+        CAN_EDIT: "CAN_EDIT";
         CAN_READ: "CAN_READ";
       }>;
       alias: z.ZodString;
@@ -1019,12 +1019,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;
@@ -1058,12 +1058,12 @@ declare const pluginManifestSchema: z.ZodObject<{
         discovery: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
           type: z.ZodLiteral<"kind">;
           resourceKind: z.ZodEnum<{
-            volume: "volume";
             warehouse: "warehouse";
             genie_space: "genie_space";
             postgres_project: "postgres_project";
             postgres_branch: "postgres_branch";
             postgres_database: "postgres_database";
+            volume: "volume";
           }>;
           select: z.ZodOptional<z.ZodString>;
           display: z.ZodOptional<z.ZodString>;

package/dist/stream/stream-manager.d.ts

@@ -1,5 +1,5 @@
-import { IAppResponse } from "../shared/src/plugin.js";
 import { StreamConfig } from "../shared/src/execute.js";
+import { IAppResponse } from "../shared/src/plugin.js";
 import "../shared/src/index.js";
 
 //#region src/stream/stream-manager.d.ts

package/dist/telemetry/index.js

@@ -2,7 +2,7 @@ import { normalizeTelemetryOptions } from "./config.js";
 import { instrumentations } from "./instrumentations.js";
 import { TelemetryProvider } from "./telemetry-provider.js";
 import { TelemetryManager } from "./telemetry-manager.js";
-import { SpanKind, SpanStatusCode } from "@opentelemetry/api";
+import { SpanKind as SpanKind$1, SpanStatusCode } from "@opentelemetry/api";
 import { SeverityNumber as SeverityNumber$1 } from "@opentelemetry/api-logs";
 
-export { SeverityNumber$1 as SeverityNumber, SpanKind, SpanStatusCode };
+export { SeverityNumber$1 as SeverityNumber, SpanKind$1 as SpanKind, SpanStatusCode };

package/dist/telemetry/telemetry-manager.d.ts

@@ -1,4 +1,5 @@
 import "../shared/src/index.js";
 import "./types.js";
 import "./telemetry-provider.js";
-import { Instrumentation } from "@opentelemetry/instrumentation";
+import { Instrumentation } from "@opentelemetry/instrumentation";
+import "@opentelemetry/sdk-trace-base";

package/dist/telemetry/telemetry-manager.js

@@ -1,24 +1,49 @@
 import { createLogger } from "../logging/logger.js";
 import { TelemetryProvider } from "./telemetry-provider.js";
 import { AppKitSampler } from "./trace-sampler.js";
+import { metrics } from "@opentelemetry/api";
+import { logs } from "@opentelemetry/api-logs";
 import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node";
 import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-proto";
 import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-proto";
 import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
 import { registerInstrumentations } from "@opentelemetry/instrumentation";
 import { detectResources, envDetector, hostDetector, processDetector, resourceFromAttributes } from "@opentelemetry/resources";
-import { BatchLogRecordProcessor } from "@opentelemetry/sdk-logs";
-import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
-import { NodeSDK } from "@opentelemetry/sdk-node";
+import { BatchLogRecordProcessor, LoggerProvider } from "@opentelemetry/sdk-logs";
+import { MeterProvider, PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
+import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
 import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from "@opentelemetry/semantic-conventions";
 
 //#region src/telemetry/telemetry-manager.ts
 const logger = createLogger("telemetry");
+/**
+* Owns the app's OpenTelemetry providers, split into two phases so plugins can
+* contribute trace span processors before the tracer provider is built.
+*
+* - `initialize()` runs at app bootstrap, before plugin setup. It registers the
+*   meter and logger providers eagerly, because OTel's metrics API has no lazy
+*   proxy: a counter/histogram bound against the NoOp meter (as every connector
+*   and the cache do in their constructors) stays NoOp for the process lifetime.
+*   It does NOT register a tracer provider.
+* - `registerSpanProcessor()` is called by plugins during `setup()` to add a
+*   span processor (e.g. an MLflow exporter) to the not-yet-built tracer.
+* - `start()` runs after all plugin `setup()` completes. It builds the single
+*   global tracer provider with the OTLP processor (if configured) plus every
+*   contributed processor. Deferring is safe for traces: OTel's ProxyTracer
+*   rebinds tracers obtained before registration, and no span is emitted during
+*   setup.
+*/
 var TelemetryManager = class TelemetryManager {
 	static DEFAULT_EXPORT_INTERVAL_MS = 1e4;
 	static DEFAULT_FALLBACK_APP_NAME = "databricks-app";
 	static instance;
-	sdk;
+	resource;
+	meterProvider;
+	loggerProvider;
+	tracerProvider;
+	spanProcessors = [];
+	started = false;
 	shutdownPromise;
 	/**
 	* Create a scoped telemetry provider for a specific plugin.
@@ -38,29 +63,84 @@ var TelemetryManager = class TelemetryManager {
 	static initialize(config = {}) {
 		TelemetryManager.getInstance()._initialize(config);
 	}
+	/**
+	* Contribute a span processor to the not-yet-built tracer provider. Called by
+	* plugins during `setup()`. No-op with a warning once `start()` has run, since
+	* a started provider's processors are immutable in OTel JS 2.x.
+	*/
+	static registerSpanProcessor(processor) {
+		TelemetryManager.getInstance()._registerSpanProcessor(processor);
+	}
+	_registerSpanProcessor(processor) {
+		if (this.started) {
+			logger.warn("registerSpanProcessor called after start(); processor ignored. Contribute span processors during plugin setup().");
+			return;
+		}
+		this.spanProcessors.push(processor);
+	}
+	/**
+	* Phase 1: register the meter and logger providers eagerly (before plugin
+	* setup), so metric instruments bound in connector/cache constructors attach
+	* to real meters. The tracer provider is deferred to `start()`.
+	*
+	* When no OTLP endpoint is configured, meter/logger registration is skipped;
+	* a contributed span processor can still bring up tracing in `start()`.
+	*/
 	_initialize(config) {
-		if (this.sdk) return;
+		if (this.resource) return;
+		this.resource = this.createResource(config);
 		if (!process.env.OTEL_EXPORTER_OTLP_ENDPOINT) return;
 		try {
-			this.sdk = new NodeSDK({
-				resource: this.createResource(config),
-				autoDetectResources: false,
-				sampler: new AppKitSampler(),
-				traceExporter: new OTLPTraceExporter({ headers: config.headers }),
-				metricReaders: [new PeriodicExportingMetricReader({
+			this.meterProvider = new MeterProvider({
+				resource: this.resource,
+				readers: [new PeriodicExportingMetricReader({
 					exporter: new OTLPMetricExporter({ headers: config.headers }),
 					exportIntervalMillis: config.exportIntervalMs || TelemetryManager.DEFAULT_EXPORT_INTERVAL_MS
-				})],
-				logRecordProcessors: [new BatchLogRecordProcessor(new OTLPLogExporter({ headers: config.headers }))],
-				instrumentations: this.getDefaultInstrumentations()
+				})]
+			});
+			metrics.setGlobalMeterProvider(this.meterProvider);
+			this.loggerProvider = new LoggerProvider({
+				resource: this.resource,
+				processors: [new BatchLogRecordProcessor(new OTLPLogExporter({ headers: config.headers }))]
 			});
-			this.sdk.start();
-			logger.debug("Initialized successfully");
+			logs.setGlobalLoggerProvider(this.loggerProvider);
+			this.spanProcessors.push(new BatchSpanProcessor(new OTLPTraceExporter({ headers: config.headers })));
+			this.registerInstrumentations(this.getDefaultInstrumentations());
+			logger.debug("Meter/logger providers initialized");
 		} catch (error) {
 			logger.error("Failed to initialize: %O", error);
 		}
 	}
 	/**
+	* Phase 2: build and register the global tracer provider. Called by core
+	* after every plugin's `setup()` completes, so all contributed span
+	* processors are known. No-op when nothing needs tracing (no OTLP endpoint
+	* and no contributed processor), preserving "no telemetry unless configured".
+	*
+	* `NodeTracerProvider.register()` installs the async-hooks context manager and
+	* W3C propagators — the same wiring `NodeSDK.start()` did — so span nesting
+	* across awaits is preserved.
+	*/
+	static start() {
+		TelemetryManager.getInstance()._start();
+	}
+	_start() {
+		if (this.started) return;
+		this.started = true;
+		if (this.spanProcessors.length === 0) return;
+		try {
+			this.tracerProvider = new NodeTracerProvider({
+				resource: this.resource,
+				sampler: new AppKitSampler(),
+				spanProcessors: this.spanProcessors
+			});
+			this.tracerProvider.register();
+			logger.debug("Tracer provider started with %d span processor(s)", this.spanProcessors.length);
+		} catch (error) {
+			logger.error("Failed to start tracer provider: %O", error);
+		}
+	}
+	/**
 	* Register OpenTelemetry instrumentations.
 	* Can be called at any time, but recommended to call in plugin constructor.
 	* @param instrumentations - Array of OpenTelemetry instrumentations to register
@@ -91,23 +171,31 @@ var TelemetryManager = class TelemetryManager {
 		})];
 	}
 	/**
-	* Flush and shut down the OpenTelemetry SDK.
+	* Flush and shut down the tracer, meter, and logger providers.
 	*
-	* Idempotent: the SDK reference is cleared synchronously and concurrent
+	* Idempotent: the provider references are cleared synchronously and concurrent
 	* or repeated calls await the same in-flight flush. Awaited by the core
 	* lifecycle manager during graceful shutdown — that manager owns the
 	* process signal handlers, so telemetry no longer registers its own.
 	*/
 	async shutdown() {
-		if (this.sdk) {
-			const sdk = this.sdk;
-			this.sdk = void 0;
+		const providers = [
+			this.tracerProvider,
+			this.meterProvider,
+			this.loggerProvider
+		].filter((p) => p !== void 0);
+		if (providers.length > 0) {
+			this.tracerProvider = void 0;
+			this.meterProvider = void 0;
+			this.loggerProvider = void 0;
 			this.shutdownPromise = (async () => {
-				try {
-					await sdk.shutdown();
-				} catch (error) {
-					logger.error("Error shutting down: %O", error);
-				}
+				await Promise.all(providers.map(async (provider) => {
+					try {
+						await provider.shutdown();
+					} catch (error) {
+						logger.error("Error shutting down: %O", error);
+					}
+				}));
 			})();
 		}
 		return this.shutdownPromise;