@vibesdotdev/logging 0.0.2 → 1.0.0-rc.4

package/dist/observability/telemetry/partial-success.js

@@ -0,0 +1,94 @@
+import * as z from 'zod/v4';
+import { attempt } from "../../core/outcome.js";
+import { OtlpExportResponseSchema, readOtlpPartialRejection } from "../../core/otlp-partial-success.js";
+/** The message the SDK's export delegate gives its diag logger for a partial success; its one argument is the JSON of `partialSuccess`. */
+export const SDK_PARTIAL_SUCCESS_MESSAGE = 'Received Partial Success response:';
+const SIGNALS = ['traces', 'metrics', 'logs'];
+/** The SDK's JSON text of a `partialSuccess`, parsed; anything else is not a partial success. */
+const PartialSuccessJsonSchema = z.string().transform((text, context) => {
+    const parsed = attempt(() => JSON.parse(text));
+    if (!parsed.failed)
+        return z.unknown().parse(parsed.value);
+    context.issues.push({ code: 'custom', message: 'not JSON', input: undefined });
+    return z.NEVER;
+});
+/** The diag message arguments, as the SDK passes them: the partial success JSON first. */
+const DiagArgumentsSchema = z.tuple([PartialSuccessJsonSchema], z.unknown());
+/**
+ * A diag logger that reports the SDK's partial-success warning, once per
+ * response, through `report`: the signal (by which rejected-record field it
+ * carries), the count and the collector's message scrubbed of `endpoint`'s
+ * credentials and the exporters' header values (`secrets`). A partial success
+ * that rejected nothing is not a failure and is not reported.
+ */
+export function createPartialSuccessDiagLogger(endpoint, secrets, report) {
+    const drop = () => { };
+    return {
+        error: drop, info: drop, debug: drop, verbose: drop,
+        warn(message, ...args) {
+            if (message !== SDK_PARTIAL_SUCCESS_MESSAGE)
+                return;
+            const parsed = DiagArgumentsSchema.safeParse(args);
+            if (!parsed.success)
+                return;
+            const response = OtlpExportResponseSchema.safeParse({ partialSuccess: parsed.data[0] });
+            if (!response.success)
+                return;
+            for (const signal of SIGNALS) {
+                const rejection = readOtlpPartialRejection(signal, response.data, endpoint, secrets);
+                if (rejection) {
+                    report(rejection);
+                    return;
+                }
+            }
+        }
+    };
+}
+/**
+ * The OpenTelemetry API's process registry, as its cross-copy singleton
+ * protocol keys it (one global slot per API major version; `@opentelemetry/api`
+ * 1.x). The diag API offers no read of the logger it holds, so this is the one
+ * place that reads it: to put back a host's diag logger when Logging's goes.
+ */
+const OTEL_API_REGISTRY_KEY = Symbol.for('opentelemetry.js.api.1');
+/** One diag level's method. */
+const DiagMethodSchema = z.custom((value) => typeof value === 'function');
+/** A diag logger: every level a method. A read that throws throws out of the parse, and the reader below catches it. */
+const DiagLoggerSchema = z.object({ error: DiagMethodSchema, warn: DiagMethodSchema, info: DiagMethodSchema, debug: DiagMethodSchema, verbose: DiagMethodSchema });
+const OtelApiRegistrySchema = z.object({ diag: z.unknown() });
+/**
+ * The diag logger the registry holds now (a host's, Logging's or none), as a
+ * copy carrying the registered wrapper's own bound methods, so two reads of one
+ * registration share their method identities; a registry that cannot be read
+ * holds none.
+ */
+function registeredDiagLogger() {
+    const read = attempt(() => {
+        const registry = OtelApiRegistrySchema.safeParse(Object.getOwnPropertyDescriptor(globalThis, OTEL_API_REGISTRY_KEY)?.value);
+        const logger = registry.success ? DiagLoggerSchema.safeParse(registry.data.diag) : undefined;
+        return logger?.success ? logger.data : undefined;
+    });
+    return read.failed ? undefined : read.value;
+}
+/**
+ * Install `reporter` as the process diag logger (level `warn`) and answer its
+ * release. The release puts back the diag logger a host set before it (at the
+ * host's own level), or leaves none when there was none; when something else
+ * replaced Logging's logger in the meantime, the release leaves that one alone.
+ */
+export function installPartialSuccessDiagLogger(api, reporter) {
+    const previous = registeredDiagLogger();
+    api.diag.setLogger(reporter, { logLevel: api.DiagLogLevel.WARN, suppressOverrideMessage: true });
+    const installed = registeredDiagLogger();
+    return () => {
+        // Still Logging's registration when its bound `warn` is the one the registry holds.
+        if (installed === undefined || registeredDiagLogger()?.warn !== installed.warn)
+            return;
+        // The previous entry is the host's logger already wrapped at its level, so it is put back passing every level.
+        if (previous)
+            api.diag.setLogger(previous, { logLevel: api.DiagLogLevel.ALL, suppressOverrideMessage: true });
+        else
+            api.diag.disable();
+    };
+}
+//# sourceMappingURL=partial-success.js.map

package/dist/observability/telemetry/partial-success.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partial-success.js","sourceRoot":"","sources":["../../../src/observability/telemetry/partial-success.ts"],"names":[],"mappings":"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"}

package/dist/observability/telemetry/sdk-lifecycle.d.ts

@@ -0,0 +1,37 @@
+export interface TelemetrySdkResource {
+    start(): void | Promise<void>;
+    shutdown(): Promise<void>;
+}
+export interface TelemetryInitializationFailure {
+    initializationError: unknown;
+    cleanupError?: unknown;
+}
+export interface TelemetryLifecycleCallbacks {
+    onStarted?(): void;
+    onInitializationFailure?(failure: TelemetryInitializationFailure): void;
+}
+/**
+ * Owns one OpenTelemetry SDK through initialization and shutdown.
+ *
+ * Initialization is deliberately non-throwing because telemetry must not take
+ * down its host. A partially started SDK is shut down immediately; if that
+ * cleanup fails, the SDK remains owned so an explicit shutdown can retry.
+ */
+export declare class TelemetrySdkLifecycle<TSdk extends TelemetrySdkResource> {
+    private sdk;
+    private initialized;
+    private initializationPromise;
+    private shutdownPromise;
+    isInitialized(): boolean;
+    /** Whether this lifecycle holds an SDK: started, or an initialization still in flight. */
+    isHeld(): boolean;
+    initialize(createSdk: () => Promise<TSdk | null>, callbacks?: TelemetryLifecycleCallbacks): Promise<void>;
+    shutdown(): Promise<void>;
+    private shutdownOnce;
+    private initializeOnce;
+    private attemptInitialization;
+    /** Shut one SDK down, releasing ownership only once it has shut down. */
+    private release;
+    private reportInitializationFailure;
+}
+//# sourceMappingURL=sdk-lifecycle.d.ts.map

package/dist/observability/telemetry/sdk-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/observability/telemetry/sdk-lifecycle.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACpC,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,8BAA8B;IAC9C,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,2BAA2B;IAC3C,SAAS,CAAC,IAAI,IAAI,CAAC;IACnB,uBAAuB,CAAC,CAAC,OAAO,EAAE,8BAA8B,GAAG,IAAI,CAAC;CACxE;AAaD;;;;;;GAMG;AACH,qBAAa,qBAAqB,CAAC,IAAI,SAAS,oBAAoB;IACnE,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAA8B;IAC3D,OAAO,CAAC,eAAe,CAA8B;IAErD,aAAa,IAAI,OAAO;IAIxB,0FAA0F;IAC1F,MAAM,IAAI,OAAO;IAIjB,UAAU,CACT,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,EACrC,SAAS,GAAE,2BAAgC,GACzC,OAAO,CAAC,IAAI,CAAC;IAahB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAYX,YAAY;YAYZ,cAAc;YASd,qBAAqB;IAkDnC,yEAAyE;YAC3D,OAAO;IAUrB,OAAO,CAAC,2BAA2B;CAcnC"}

package/dist/observability/telemetry/sdk-lifecycle.js

@@ -0,0 +1,132 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+/**
+ * Owns one OpenTelemetry SDK through initialization and shutdown.
+ *
+ * Initialization is deliberately non-throwing because telemetry must not take
+ * down its host. A partially started SDK is shut down immediately; if that
+ * cleanup fails, the SDK remains owned so an explicit shutdown can retry.
+ */
+export class TelemetrySdkLifecycle {
+    sdk = null;
+    initialized = false;
+    initializationPromise = null;
+    shutdownPromise = null;
+    isInitialized() {
+        return this.initialized;
+    }
+    /** Whether this lifecycle holds an SDK: started, or an initialization still in flight. */
+    isHeld() {
+        return this.initialized || this.initializationPromise !== null;
+    }
+    initialize(createSdk, callbacks = {}) {
+        if (this.initialized)
+            return Promise.resolve();
+        if (this.initializationPromise)
+            return this.initializationPromise;
+        const initializeOperation = this.initializeOnce(this.shutdownPromise, createSdk, callbacks).finally(() => {
+            if (this.initializationPromise === initializeOperation) {
+                this.initializationPromise = null;
+            }
+        });
+        this.initializationPromise = initializeOperation;
+        return initializeOperation;
+    }
+    shutdown() {
+        if (this.shutdownPromise)
+            return this.shutdownPromise;
+        const shutdownOperation = this.shutdownOnce(this.initializationPromise).finally(() => {
+            if (this.shutdownPromise === shutdownOperation) {
+                this.shutdownPromise = null;
+            }
+        });
+        this.shutdownPromise = shutdownOperation;
+        return shutdownOperation;
+    }
+    async shutdownOnce(pendingInitialization) {
+        if (pendingInitialization)
+            await pendingInitialization;
+        const activeSdk = this.sdk;
+        if (!activeSdk)
+            return;
+        await activeSdk.shutdown();
+        if (this.sdk === activeSdk) {
+            this.sdk = null;
+            this.initialized = false;
+        }
+    }
+    async initializeOnce(pendingShutdown, createSdk, callbacks) {
+        const outcome = await this.attemptInitialization(pendingShutdown, createSdk, callbacks);
+        if (outcome.failure)
+            this.reportInitializationFailure(callbacks, outcome.failure);
+    }
+    async attemptInitialization(pendingShutdown, createSdk, callbacks) {
+        if (pendingShutdown) {
+            try {
+                await pendingShutdown;
+            }
+            catch (error) {
+                return {
+                    failure: {
+                        initializationError: new Error('OpenTelemetry initialization could not start because prior shutdown failed', { cause: error })
+                    }
+                };
+            }
+        }
+        if (this.sdk) {
+            const partialRelease = await this.release(this.sdk);
+            if (!partialRelease.released) {
+                return {
+                    failure: {
+                        initializationError: new Error('OpenTelemetry still owns a partially initialized SDK'),
+                        cleanupError: partialRelease.cleanupError
+                    }
+                };
+            }
+        }
+        let candidate = null;
+        try {
+            candidate = await createSdk();
+            if (!candidate)
+                return { failure: null };
+            this.sdk = candidate;
+            await candidate.start();
+            this.initialized = true;
+            callbacks.onStarted?.();
+            return { failure: null };
+        }
+        catch (initializationError) {
+            this.initialized = false;
+            const failure = { initializationError };
+            const candidateRelease = candidate ? await this.release(candidate) : null;
+            if (candidateRelease && !candidateRelease.released)
+                failure.cleanupError = candidateRelease.cleanupError;
+            return { failure };
+        }
+    }
+    /** Shut one SDK down, releasing ownership only once it has shut down. */
+    async release(sdk) {
+        try {
+            await sdk.shutdown();
+            if (this.sdk === sdk)
+                this.sdk = null;
+            return { released: true };
+        }
+        catch (cleanupError) {
+            return { released: false, cleanupError };
+        }
+    }
+    reportInitializationFailure(callbacks, failure) {
+        try {
+            callbacks.onInitializationFailure?.(failure);
+        }
+        catch (error) {
+            // A reporter cancelled with its runtime has nowhere left to report,
+            // so initialization stays fail-open. Any other reporter failure is
+            // a defect and propagates.
+            if (error instanceof CapabilityError && error.code === 'CANCELLED')
+                return;
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=sdk-lifecycle.js.map

package/dist/observability/telemetry/sdk-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-lifecycle.js","sourceRoot":"","sources":["../../../src/observability/telemetry/sdk-lifecycle.ts"],"names":[],"mappings":"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"}

package/dist/observability/telemetry/telemetry-root.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Per-Runtime telemetry state and the one process-wide fact telemetry cannot
+ * avoid.
+ *
+ * Everything Logging keeps about telemetry belongs to the Root that started
+ * it: its SDK lifecycle and its last typed outcome, keyed by that Root's
+ * `loggingRootOf(runtime)`. The Root, its plugin views, every reload generation
+ * and the generation dispatcher reach the same state (a generation asking is
+ * the Root asking, never another Runtime); two Roots in one process never
+ * share it.
+ *
+ * The OpenTelemetry SDK is the exception. `NodeSDK.start()` registers the
+ * tracer, meter and logger providers and patches the instrumented modules in
+ * the one global registry of the process (`@opentelemetry/api`'s own global),
+ * and a second registration is silently ignored by the SDK. Two Roots cannot
+ * each own that registry, so the first Root to start telemetry owns it and any
+ * other Root that asks gets a typed `CONFLICT` refusal, not a warning and not
+ * a no-op. The SDK's diag logger is the same kind of process-wide fact: the
+ * owner Root installs the partial-success reporter on it when its SDK starts
+ * and removes it when that SDK shuts down. The claim lasts while the owner's SDK is held (started or starting)
+ * and ends when it shuts down (`shutdownTelemetry`, `disposeObservability`,
+ * or Logging's last finalization on the Root) or fails to start. A
+ * generation's retirement does not end it, nor does disposing a Root whose SDK
+ * nobody stopped: the registry is still taken.
+ */
+import { CapabilityError, type RuntimeRef } from '@vibesdotdev/kernel';
+import type { LoggedError } from '../../core/redact.ts';
+import type { TelemetryHeadersSource } from '../../core/otlp-headers.ts';
+import { TelemetrySdkLifecycle, type TelemetrySdkResource } from './sdk-lifecycle.ts';
+/**
+ * The typed outcome of a Runtime's last `initializeTelemetry` call, observable through
+ * `getTelemetryStatus(runtime).outcome` and `getTelemetryInitializationOutcome(runtime)`.
+ * A host that does not start telemetry says why; nothing is silently skipped.
+ */
+export type TelemetryInitializationOutcome = {
+    readonly status: 'not-attempted';
+} | {
+    readonly status: 'started';
+    readonly headers: TelemetryHeadersSource;
+} | {
+    readonly status: 'already-initialized';
+} | {
+    readonly status: 'disabled';
+    readonly reason: 'explicit-off' | 'not-enabled';
+} | {
+    readonly status: 'unavailable';
+    readonly reason: 'otel-modules-absent';
+    readonly absentModules: readonly string[];
+} | {
+    readonly status: 'unavailable';
+    readonly reason: 'trace-exporter-absent';
+} | {
+    readonly status: 'failed';
+    readonly reason: 'telemetry-config-invalid' | 'otel-headers-unresolved' | 'otel-ambient-headers' | 'initialization-failed' | 'concurrent-initialization-failed' | 'telemetry-owned-by-another-runtime';
+    readonly error: LoggedError | null;
+};
+/** One Root's telemetry: its SDK, its last outcome, and the diag logger it installed while it owns the registry. */
+export interface TelemetryRootState {
+    readonly sdk: TelemetrySdkLifecycle<TelemetrySdkResource>;
+    outcome: TelemetryInitializationOutcome;
+    /** Removes the partial-success diag logger this Root installed when its SDK started; set only while it is installed. */
+    releaseDiagnostics?: () => void;
+}
+/** This Root's telemetry state, created on first use. */
+export declare function telemetryStateFor(runtime: RuntimeRef): TelemetryRootState;
+/** This Root's telemetry state if it ever asked for any. */
+export declare function existingTelemetryState(runtime: RuntimeRef): TelemetryRootState | undefined;
+/**
+ * Claim the process's OpenTelemetry registry for `runtime`'s Root. Returns the
+ * typed refusal when another Root holds an SDK on it; the owning Root (through
+ * any of its runtimes) claims again without conflict.
+ */
+export declare function claimTelemetryRegistry(runtime: RuntimeRef): CapabilityError | null;
+/** End `runtime`'s Root's claim on the OpenTelemetry registry; another Root's claim is untouched. */
+export declare function releaseTelemetryRegistry(runtime: RuntimeRef): void;
+/** Shut down this Root's SDK, if it started one, and end its registry claim once it has stopped. */
+export declare function shutdownRuntimeTelemetry(runtime: RuntimeRef): Promise<void>;
+//# sourceMappingURL=telemetry-root.d.ts.map

package/dist/observability/telemetry/telemetry-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-root.d.ts","sourceRoot":"","sources":["../../../src/observability/telemetry/telemetry-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAItF;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GACvC;IAAE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GACpC;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAA;CAAE,GACxE;IAAE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAC1C;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACrH;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,0BAA0B,GAAG,yBAAyB,GAAG,sBAAsB,GAAG,uBAAuB,GAAG,kCAAkC,GAAG,oCAAoC,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,CAAC;AAE7Q,oHAAoH;AACpH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,GAAG,EAAE,qBAAqB,CAAC,oBAAoB,CAAC,CAAC;IAC1D,OAAO,EAAE,8BAA8B,CAAC;IACxC,wHAAwH;IACxH,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC;AASD,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,kBAAkB,CAOzE;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,GAAG,kBAAkB,GAAG,SAAS,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,GAAG,eAAe,GAAG,IAAI,CAUlF;AAED,qGAAqG;AACrG,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAElE;AAED,oGAAoG;AACpG,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CASjF"}

package/dist/observability/telemetry/telemetry-root.js

@@ -0,0 +1,79 @@
+/**
+ * Per-Runtime telemetry state and the one process-wide fact telemetry cannot
+ * avoid.
+ *
+ * Everything Logging keeps about telemetry belongs to the Root that started
+ * it: its SDK lifecycle and its last typed outcome, keyed by that Root's
+ * `loggingRootOf(runtime)`. The Root, its plugin views, every reload generation
+ * and the generation dispatcher reach the same state (a generation asking is
+ * the Root asking, never another Runtime); two Roots in one process never
+ * share it.
+ *
+ * The OpenTelemetry SDK is the exception. `NodeSDK.start()` registers the
+ * tracer, meter and logger providers and patches the instrumented modules in
+ * the one global registry of the process (`@opentelemetry/api`'s own global),
+ * and a second registration is silently ignored by the SDK. Two Roots cannot
+ * each own that registry, so the first Root to start telemetry owns it and any
+ * other Root that asks gets a typed `CONFLICT` refusal, not a warning and not
+ * a no-op. The SDK's diag logger is the same kind of process-wide fact: the
+ * owner Root installs the partial-success reporter on it when its SDK starts
+ * and removes it when that SDK shuts down. The claim lasts while the owner's SDK is held (started or starting)
+ * and ends when it shuts down (`shutdownTelemetry`, `disposeObservability`,
+ * or Logging's last finalization on the Root) or fails to start. A
+ * generation's retirement does not end it, nor does disposing a Root whose SDK
+ * nobody stopped: the registry is still taken.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { TelemetrySdkLifecycle } from "./sdk-lifecycle.js";
+import { loggingRootOf } from "../../core/root-identity.js";
+const stateByRoot = new WeakMap();
+/** The Root that owns the process's OpenTelemetry global registry; weak, so a collected Root never pins it. */
+let registryOwner = null;
+/** This Root's telemetry state, created on first use. */
+export function telemetryStateFor(runtime) {
+    let state = stateByRoot.get(loggingRootOf(runtime));
+    if (!state) {
+        state = { sdk: new TelemetrySdkLifecycle(), outcome: { status: 'not-attempted' } };
+        stateByRoot.set(loggingRootOf(runtime), state);
+    }
+    return state;
+}
+/** This Root's telemetry state if it ever asked for any. */
+export function existingTelemetryState(runtime) {
+    return stateByRoot.get(loggingRootOf(runtime));
+}
+/**
+ * Claim the process's OpenTelemetry registry for `runtime`'s Root. Returns the
+ * typed refusal when another Root holds an SDK on it; the owning Root (through
+ * any of its runtimes) claims again without conflict.
+ */
+export function claimTelemetryRegistry(runtime) {
+    const owner = registryOwner?.deref();
+    if (owner && owner !== loggingRootOf(runtime) && stateByRoot.get(owner)?.sdk.isHeld()) {
+        return new CapabilityError('OpenTelemetry not started: another Runtime in this process owns the OpenTelemetry global registry.', 'CONFLICT', {
+            reason: 'telemetry-owned-by-another-runtime', retryable: false,
+            recoveryHint: 'Start telemetry on one Runtime per process, or shut the owning Runtime telemetry down first.'
+        });
+    }
+    registryOwner = new WeakRef(loggingRootOf(runtime));
+    return null;
+}
+/** End `runtime`'s Root's claim on the OpenTelemetry registry; another Root's claim is untouched. */
+export function releaseTelemetryRegistry(runtime) {
+    if (registryOwner?.deref() === loggingRootOf(runtime))
+        registryOwner = null;
+}
+/** Shut down this Root's SDK, if it started one, and end its registry claim once it has stopped. */
+export async function shutdownRuntimeTelemetry(runtime) {
+    const state = existingTelemetryState(runtime);
+    if (!state)
+        return;
+    await state.sdk.shutdown();
+    if (state.sdk.isInitialized())
+        return;
+    // The SDK has flushed and stopped, so its last partial success was reported; the diag logger goes with the claim.
+    state.releaseDiagnostics?.();
+    delete state.releaseDiagnostics;
+    releaseTelemetryRegistry(runtime);
+}
+//# sourceMappingURL=telemetry-root.js.map

package/dist/observability/telemetry/telemetry-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-root.js","sourceRoot":"","sources":["../../../src/observability/telemetry/telemetry-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,eAAe,EAAmB,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAE,qBAAqB,EAA6B,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AA2B5D,MAAM,WAAW,GAAG,IAAI,OAAO,EAAoC,CAAC;AAEpE,+GAA+G;AAC/G,IAAI,aAAa,GAAiC,IAAI,CAAC;AAEvD,yDAAyD;AACzD,MAAM,UAAU,iBAAiB,CAAC,OAAmB;IACpD,IAAI,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,KAAK,GAAG,EAAE,GAAG,EAAE,IAAI,qBAAqB,EAAwB,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,CAAC;QACzG,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,sBAAsB,CAAC,OAAmB;IACzD,OAAO,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAmB;IACzD,MAAM,KAAK,GAAG,aAAa,EAAE,KAAK,EAAE,CAAC;IACrC,IAAI,KAAK,IAAI,KAAK,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QACvF,OAAO,IAAI,eAAe,CAAC,oGAAoG,EAAE,UAAU,EAAE;YAC5I,MAAM,EAAE,oCAAoC,EAAE,SAAS,EAAE,KAAK;YAC9D,YAAY,EAAE,8FAA8F;SAC5G,CAAC,CAAC;IACJ,CAAC;IACD,aAAa,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,wBAAwB,CAAC,OAAmB;IAC3D,IAAI,aAAa,EAAE,KAAK,EAAE,KAAK,aAAa,CAAC,OAAO,CAAC;QAAE,aAAa,GAAG,IAAI,CAAC;AAC7E,CAAC;AAED,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAAmB;IACjE,MAAM,KAAK,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE;QAAE,OAAO;IACtC,kHAAkH;IAClH,KAAK,CAAC,kBAAkB,EAAE,EAAE,CAAC;IAC7B,OAAO,KAAK,CAAC,kBAAkB,CAAC;IAChC,wBAAwB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC"}

package/dist/observability/telemetry-instrumentation.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Provider-neutral OpenTelemetry instrumentation seam.
+ *
+ * Framework owns this kind and the NodeSDK lifecycle. Integrations register
+ * provider factories (AWS SDK, Redis/ioredis) through this seam.
+ * Framework never imports a provider implementation.
+ */
+import type { RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/descriptor';
+import type { KindContext, RuntimeKindDescriptor } from '@vibesdotdev/kernel/schemas/kind';
+import * as z from 'zod/v4';
+export declare const TELEMETRY_INSTRUMENTATION_KIND: "observability/telemetry-instrumentation";
+/** Provider instrumentation options: JSON configuration keyed by option name. */
+export declare const TelemetryInstrumentationOptionsSchema: z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+export type TelemetryInstrumentationOptions = z.infer<typeof TelemetryInstrumentationOptionsSchema>;
+export interface TelemetryInstrumentationFactory {
+    (options?: TelemetryInstrumentationOptions): object;
+}
+export interface TelemetryInstrumentationDescriptor extends RuntimeDescriptor {
+    kind: typeof TELEMETRY_INSTRUMENTATION_KIND;
+    config?: {
+        package: string;
+        version: string;
+    };
+}
+export declare const TelemetryInstrumentationDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"observability/telemetry-instrumentation">;
+    config: z.ZodOptional<z.ZodObject<{
+        package: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const telemetryInstrumentationKind: RuntimeKindDescriptor<TelemetryInstrumentationDescriptor, TelemetryInstrumentationFactory, KindContext>;
+/** The runtime a telemetry host resolves provider instrumentations on (only its registry is read). */
+export interface TelemetryRuntimeQuery {
+    hasKind(kind: string): boolean;
+    query<TDescriptor extends RuntimeDescriptor, TImpl>(kind: string): {
+        enabled(): {
+            descriptors(): TDescriptor[];
+        };
+        withId(id: string): {
+            resolve(): Promise<TImpl>;
+        };
+    };
+}
+/**
+ * Resolve one provider instrumentation factory by id and build it. `null`
+ * only when the kind or that descriptor is not composed on this runtime (the
+ * confirmed absence); a composed provider that fails to load rejects.
+ */
+export declare function resolveTelemetryInstrumentation(runtime: TelemetryRuntimeQuery, id: string): Promise<object | null>;
+/**
+ * Every provider instrumentation the host composed on `runtime` (AWS SDK from
+ * `@vibesdotdev/integrations-aws`, Redis/ioredis from
+ * `@vibesdotdev/integrations-redis`, …), built. Framework imports none of them.
+ */
+export declare function resolveComposedTelemetryInstrumentations(runtime: TelemetryRuntimeQuery): Promise<object[]>;
+//# sourceMappingURL=telemetry-instrumentation.d.ts.map

package/dist/observability/telemetry-instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-instrumentation.d.ts","sourceRoot":"","sources":["../../src/observability/telemetry-instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE3F,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,8BAA8B,EAAG,yCAAkD,CAAC;AAEjG,iFAAiF;AACjF,eAAO,MAAM,qCAAqC,2QAAwC,CAAC;AAC3F,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG,MAAM,WAAW,+BAA+B;IAC/C,CAAC,OAAO,CAAC,EAAE,+BAA+B,GAAG,MAAM,CAAC;CACpD;AAED,MAAM,WAAW,kCAAmC,SAAQ,iBAAiB;IAC5E,IAAI,EAAE,OAAO,8BAA8B,CAAC;IAC5C,MAAM,CAAC,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;CACF;AAED,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;iBAQnD,CAAC;AAOH,eAAO,MAAM,4BAA4B,EAAE,qBAAqB,CAC/D,kCAAkC,EAClC,+BAA+B,EAC/B,WAAW,CAKX,CAAC;AAEF,sGAAsG;AACtG,MAAM,WAAW,qBAAqB;IACrC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,KAAK,CAAC,WAAW,SAAS,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG;QAClE,OAAO,IAAI;YAAE,WAAW,IAAI,WAAW,EAAE,CAAA;SAAE,CAAC;QAC5C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG;YAAE,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,CAAA;SAAE,CAAC;KAClD,CAAC;CACF;AAED;;;;GAIG;AACH,wBAAsB,+BAA+B,CACpD,OAAO,EAAE,qBAAqB,EAC9B,EAAE,EAAE,MAAM,GACR,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBxB;AAED;;;;GAIG;AACH,wBAAsB,wCAAwC,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAShH"}

package/dist/observability/telemetry-instrumentation.js

@@ -0,0 +1,69 @@
+/**
+ * Provider-neutral OpenTelemetry instrumentation seam.
+ *
+ * Framework owns this kind and the NodeSDK lifecycle. Integrations register
+ * provider factories (AWS SDK, Redis/ioredis) through this seam.
+ * Framework never imports a provider implementation.
+ */
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+import * as z from 'zod/v4';
+export const TELEMETRY_INSTRUMENTATION_KIND = 'observability/telemetry-instrumentation';
+/** Provider instrumentation options: JSON configuration keyed by option name. */
+export const TelemetryInstrumentationOptionsSchema = z.record(z.string(), JsonValueSchema);
+export const TelemetryInstrumentationDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal(TELEMETRY_INSTRUMENTATION_KIND),
+    config: z
+        .object({
+        package: z.string().min(1),
+        version: z.string().min(1)
+    })
+        .optional()
+});
+/** A resolved provider implementation is admitted only as a callable factory. */
+const TelemetryInstrumentationFactorySchema = z.custom((value) => value instanceof Function);
+export const telemetryInstrumentationKind = {
+    id: TELEMETRY_INSTRUMENTATION_KIND,
+    descriptorSchema: TelemetryInstrumentationDescriptorSchema,
+    contexts: []
+};
+/**
+ * Resolve one provider instrumentation factory by id and build it. `null`
+ * only when the kind or that descriptor is not composed on this runtime (the
+ * confirmed absence); a composed provider that fails to load rejects.
+ */
+export async function resolveTelemetryInstrumentation(runtime, id) {
+    if (!runtime.hasKind(TELEMETRY_INSTRUMENTATION_KIND))
+        return null;
+    const composed = runtime
+        .query(TELEMETRY_INSTRUMENTATION_KIND)
+        .enabled()
+        .descriptors()
+        .some((descriptor) => descriptor.id === id);
+    if (!composed)
+        return null;
+    const factory = TelemetryInstrumentationFactorySchema.safeParse(
+    // The loader's value is unverified until parsed here, at the provider boundary.
+    await runtime.query(TELEMETRY_INSTRUMENTATION_KIND).withId(id).resolve());
+    if (!factory.success) {
+        throw new Error(`Telemetry instrumentation '${id}' did not load a factory function.`);
+    }
+    return factory.data();
+}
+/**
+ * Every provider instrumentation the host composed on `runtime` (AWS SDK from
+ * `@vibesdotdev/integrations-aws`, Redis/ioredis from
+ * `@vibesdotdev/integrations-redis`, …), built. Framework imports none of them.
+ */
+export async function resolveComposedTelemetryInstrumentations(runtime) {
+    if (!runtime.hasKind(TELEMETRY_INSTRUMENTATION_KIND))
+        return [];
+    const ids = runtime
+        .query(TELEMETRY_INSTRUMENTATION_KIND)
+        .enabled()
+        .descriptors()
+        .map((descriptor) => descriptor.id);
+    const built = await Promise.all(ids.map((id) => resolveTelemetryInstrumentation(runtime, id)));
+    return built.filter((instrumentation) => instrumentation !== null);
+}
+//# sourceMappingURL=telemetry-instrumentation.js.map

package/dist/observability/telemetry-instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-instrumentation.js","sourceRoot":"","sources":["../../src/observability/telemetry-instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,8BAA8B,GAAG,yCAAkD,CAAC;AAEjG,iFAAiF;AACjF,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC;AAe3F,MAAM,CAAC,MAAM,wCAAwC,GAAG,uBAAuB,CAAC,MAAM,CAAC;IACtF,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC;IAC/C,MAAM,EAAE,CAAC;SACP,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC1B,CAAC;SACD,QAAQ,EAAE;CACZ,CAAC,CAAC;AAEH,iFAAiF;AACjF,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CACrD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,QAAQ,CACpC,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAIrC;IACH,EAAE,EAAE,8BAA8B;IAClC,gBAAgB,EAAE,wCAAwC;IAC1D,QAAQ,EAAE,EAAE;CACZ,CAAC;AAWF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACpD,OAA8B,EAC9B,EAAU;IAEV,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,8BAA8B,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,MAAM,QAAQ,GAAG,OAAO;SACtB,KAAK,CAAsE,8BAA8B,CAAC;SAC1G,OAAO,EAAE;SACT,WAAW,EAAE;SACb,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,OAAO,GAAG,qCAAqC,CAAC,SAAS;IAC9D,gFAAgF;IAChF,MAAM,OAAO,CAAC,KAAK,CAAsE,8BAA8B,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAC7I,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,8BAA8B,EAAE,oCAAoC,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,wCAAwC,CAAC,OAA8B;IAC5F,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,8BAA8B,CAAC;QAAE,OAAO,EAAE,CAAC;IAChE,MAAM,GAAG,GAAG,OAAO;SACjB,KAAK,CAAsE,8BAA8B,CAAC;SAC1G,OAAO,EAAE;SACT,WAAW,EAAE;SACb,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,+BAA+B,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/F,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,eAAe,EAA6B,EAAE,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC;AAC/F,CAAC"}

package/dist/otel/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @vibesdotdev/logging/otel
+ *
+ * OpenTelemetry log sink for vibes logging.
+ */
+export { default as loggingOtelPlugin, loggingOtelPlugin as default } from './logging-otel.plugin.ts';
+export { otelSinkDescriptor } from './sinks/otel/otel.descriptor.ts';
+export { default as OtelSink } from './sinks/otel/otel.impl.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/otel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/otel/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,iBAAiB,IAAI,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAGtG,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAGrE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/otel/index.js

@@ -0,0 +1,12 @@
+/**
+ * @vibesdotdev/logging/otel
+ *
+ * OpenTelemetry log sink for vibes logging.
+ */
+// Plugin
+export { default as loggingOtelPlugin, loggingOtelPlugin as default } from "./logging-otel.plugin.js";
+// Sink descriptors
+export { otelSinkDescriptor } from "./sinks/otel/otel.descriptor.js";
+// Implementation (for direct use / testing)
+export { default as OtelSink } from "./sinks/otel/otel.impl.js";
+//# sourceMappingURL=index.js.map

package/dist/otel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/otel/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,SAAS;AACT,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,iBAAiB,IAAI,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEtG,mBAAmB;AACnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,4CAA4C;AAC5C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,2BAA2B,CAAC"}