@telorun/kernel 0.49.0 → 0.50.0

package/dist/logging/logging-pipeline.d.ts

@@ -0,0 +1,89 @@
+import { type LogAttributes, type LogAttributesInput, type LogOptions, type Logger, type ResourceRef } from "@telorun/sdk";
+import type { DropCause, LogSinkInstance } from "./log-sink.js";
+import { type AttributeLimits } from "./normalize-attributes.js";
+import type { ScopeConfig } from "./scope-config.js";
+export type { ScopeConfig } from "./scope-config.js";
+/**
+ * The emission pipeline — `kernel/specs/logging.md` §10.1:
+ *
+ *     controller → Logger → [threshold] → [redaction] → [sampling] → fan-out → Sink₁..Sinkₙ
+ *
+ * Redaction runs **before** serialization and before any sink sees the record.
+ *
+ * The logger core is deliberately independent of the sink set (D1): the debug
+ * wire is *one sink*, not the pipeline. Logging works with no debug consumer
+ * attached and with tracing off, and no sink depends on the event bus — which
+ * short-circuits to zero cost when unsubscribed and therefore cannot carry logs.
+ */
+/** Ambient span context, supplied by the host so §7.2's automatic attachment
+ *  needs no cooperation from the controller. Returns `undefined` when no span is
+ *  active, in which case all three trace fields are omitted. */
+export type TraceContextProvider = () => {
+    traceId: string;
+    spanId: string;
+    traceFlags?: number;
+} | undefined;
+export declare const ROOT_SCOPE_CONFIG: ScopeConfig;
+export interface PipelineOptions {
+    /** The process's real stderr — the fallback diagnostic stream of §8.4. This is
+     *  the one place a logger may not surface an error inline; it is reported
+     *  out-of-band, never swallowed. */
+    fallbackStream: {
+        write(chunk: string): unknown;
+    };
+    traceContext?: TraceContextProvider;
+    limits?: AttributeLimits;
+    /** Records held before the first declared sink attaches, replayed in order
+     *  (§12.1). Bounded, and overflow is counted like any other drop. */
+    bootstrapCapacity?: number;
+}
+export declare class LoggingPipeline {
+    #private;
+    constructor(options: PipelineOptions);
+    /** Wire the ambient trace source once the kernel's tracer exists. */
+    setTraceContextProvider(provider: TraceContextProvider | undefined): void;
+    get sinkCount(): number;
+    /**
+     * Attach a sink and replay the bootstrap backlog into it, in original order.
+     * Attaching changes the minimum-level gate, so it is recomputed and the new
+     * threshold propagates to guests (§12.4).
+     */
+    attach(sink: LogSinkInstance): void;
+    detach(sink: LogSinkInstance): void;
+    /**
+     * Stop holding records for replay. Called once every declared sink has
+     * attached: the bootstrap buffer covers the pre-attach window, and a consumer
+     * connecting later (the debug wire) wants the live stream, not the whole
+     * process history.
+     */
+    sealBootstrap(): void;
+    /**
+     * The severity at or above which a record is created for a scope at
+     * `scopeThreshold`: the minimum — most verbose — effective level across all
+     * attached sinks. A record failing this gate reaches no sink and is never
+     * created, formatted, or sent across an FFI boundary.
+     *
+     * With no sink attached the scope's own threshold governs, so records still
+     * reach the bootstrap buffer and are replayed once a sink arrives.
+     */
+    gateFor(scopeThreshold: number): number;
+    get gateVersion(): number;
+    /** Count a drop against a sink. Exposed so a sink's own buffer can report
+     *  saturation without reaching into the registry directly. */
+    recordDrop(sinkId: string, cause: DropCause, count?: number): void;
+    /** Lifetime drop total for a (sink, cause) pair, for assertions and for the
+     *  shutdown report. */
+    dropTotal(sinkId: string, cause: DropCause): number;
+    createLogger(scope: ScopeConfig, resource?: ResourceRef, bound?: LogAttributes): Logger;
+    /** Build and dispatch a record. Never throws (§8.4). */
+    emit(scope: ScopeConfig, severity: number, message: string, resource: ResourceRef | undefined, bound: LogAttributes | undefined, attributes: LogAttributesInput | undefined, options: LogOptions | undefined): void;
+    /** §10.5's fatal tiering: drain every sync-flushable sink to completion before
+     *  returning, and merely *initiate* the rest. Blocking on a sink that cannot
+     *  be synchronously drained is a deadlock on an event loop, not durability. */
+    flushFatal(): void;
+    flush(): Promise<void>;
+    /** Final flush and release. Outstanding drop reports are emitted first so a
+     *  run that ends while still dropping does not lose its accounting. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=logging-pipeline.d.ts.map

package/dist/logging/logging-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-pipeline.d.ts","sourceRoot":"","sources":["../../src/logging/logging-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,MAAM,EAEX,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;;;;;;;;GAWG;AAEH;;gEAEgE;AAChE,MAAM,MAAM,oBAAoB,GAAG,MAC/B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,SAAS,CAAC;AAEd,eAAO,MAAM,iBAAiB,EAAE,WAG/B,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B;;wCAEoC;IACpC,cAAc,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAClD,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;yEACqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAKD,qBAAa,eAAe;;gBAkBd,OAAO,EAAE,eAAe;IAQpC,qEAAqE;IACrE,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GAAG,IAAI;IAIzE,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAUnC,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAMnC;;;;;OAKG;IACH,aAAa,IAAI,IAAI;IAQrB;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAevC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;kEAC8D;IAC9D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,SAAI,GAAG,IAAI;IAI7D;2BACuB;IACvB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM;IAInD,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM;IAIvF,wDAAwD;IACxD,IAAI,CACF,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,WAAW,GAAG,SAAS,EACjC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,UAAU,EAAE,kBAAkB,GAAG,SAAS,EAC1C,OAAO,EAAE,UAAU,GAAG,SAAS,GAC9B,IAAI;IA0HP;;mFAE+E;IAC/E,UAAU,IAAI,IAAI;IAWZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B;2EACuE;IACjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAkD7B"}

package/dist/logging/logging-pipeline.js

@@ -0,0 +1,349 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _LoggingPipeline_instances, _LoggingPipeline_sinks, _LoggingPipeline_drops, _LoggingPipeline_fallback, _LoggingPipeline_limits, _LoggingPipeline_bootstrapCapacity, _LoggingPipeline_traceContext, _LoggingPipeline_gateVersion, _LoggingPipeline_gateCache, _LoggingPipeline_bootstrap, _LoggingPipeline_bootstrapDropped, _LoggingPipeline_samplers, _LoggingPipeline_lastFallbackReport, _LoggingPipeline_buildRecord, _LoggingPipeline_dispatch, _LoggingPipeline_writeTo, _LoggingPipeline_bufferBootstrap, _LoggingPipeline_samplerFor, _LoggingPipeline_invalidateGate, _LoggingPipeline_reportDrops, _LoggingPipeline_reportFallback, _ScopedLogger_pipeline, _ScopedLogger_scope, _ScopedLogger_resource, _ScopedLogger_bound, _ScopedLogger_cachedGate, _ScopedLogger_cachedVersion;
+import { nowUnixNano, severityText as canonicalSeverityText, SEVERITY, } from "@telorun/sdk";
+import { DropRegistry, PIPELINE_SINK_ID } from "./drop-accounting.js";
+import { normalizeAttributes } from "./normalize-attributes.js";
+import { EMPTY_REDACTION_POLICY, redactAttributes, redactError } from "./redact-attributes.js";
+import { Sampler } from "./sampler.js";
+import { toErrorValue } from "./to-error-value.js";
+export const ROOT_SCOPE_CONFIG = {
+    threshold: SEVERITY.info,
+    redaction: EMPTY_REDACTION_POLICY,
+};
+const DEFAULT_BOOTSTRAP_CAPACITY = 1024;
+const FALLBACK_REPORT_INTERVAL_MS = 5000;
+export class LoggingPipeline {
+    constructor(options) {
+        _LoggingPipeline_instances.add(this);
+        _LoggingPipeline_sinks.set(this, []);
+        _LoggingPipeline_drops.set(this, void 0);
+        _LoggingPipeline_fallback.set(this, void 0);
+        _LoggingPipeline_limits.set(this, void 0);
+        _LoggingPipeline_bootstrapCapacity.set(this, void 0);
+        _LoggingPipeline_traceContext.set(this, void 0);
+        /** Bumped whenever the sink set changes, so a logger's cached gate
+         *  invalidates without every logger being tracked and rewritten (§12.4). */
+        _LoggingPipeline_gateVersion.set(this, 0);
+        _LoggingPipeline_gateCache.set(this, new Map());
+        _LoggingPipeline_bootstrap.set(this, []);
+        _LoggingPipeline_bootstrapDropped.set(this, 0);
+        _LoggingPipeline_samplers.set(this, new Map());
+        _LoggingPipeline_lastFallbackReport.set(this, new Map());
+        __classPrivateFieldSet(this, _LoggingPipeline_fallback, options.fallbackStream, "f");
+        __classPrivateFieldSet(this, _LoggingPipeline_traceContext, options.traceContext, "f");
+        __classPrivateFieldSet(this, _LoggingPipeline_limits, options.limits, "f");
+        __classPrivateFieldSet(this, _LoggingPipeline_bootstrapCapacity, options.bootstrapCapacity ?? DEFAULT_BOOTSTRAP_CAPACITY, "f");
+        __classPrivateFieldSet(this, _LoggingPipeline_drops, new DropRegistry((report) => __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_reportDrops).call(this, report)), "f");
+    }
+    /** Wire the ambient trace source once the kernel's tracer exists. */
+    setTraceContextProvider(provider) {
+        __classPrivateFieldSet(this, _LoggingPipeline_traceContext, provider, "f");
+    }
+    get sinkCount() {
+        return __classPrivateFieldGet(this, _LoggingPipeline_sinks, "f").length;
+    }
+    /**
+     * Attach a sink and replay the bootstrap backlog into it, in original order.
+     * Attaching changes the minimum-level gate, so it is recomputed and the new
+     * threshold propagates to guests (§12.4).
+     */
+    attach(sink) {
+        __classPrivateFieldGet(this, _LoggingPipeline_sinks, "f").push(sink);
+        __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_invalidateGate).call(this);
+        if (__classPrivateFieldGet(this, _LoggingPipeline_bootstrap, "f")) {
+            for (const record of __classPrivateFieldGet(this, _LoggingPipeline_bootstrap, "f")) {
+                if (record.severityNumber >= sink.level)
+                    __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_writeTo).call(this, sink, record);
+            }
+        }
+    }
+    detach(sink) {
+        const index = __classPrivateFieldGet(this, _LoggingPipeline_sinks, "f").indexOf(sink);
+        if (index >= 0)
+            __classPrivateFieldGet(this, _LoggingPipeline_sinks, "f").splice(index, 1);
+        __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_invalidateGate).call(this);
+    }
+    /**
+     * Stop holding records for replay. Called once every declared sink has
+     * attached: the bootstrap buffer covers the pre-attach window, and a consumer
+     * connecting later (the debug wire) wants the live stream, not the whole
+     * process history.
+     */
+    sealBootstrap() {
+        if (__classPrivateFieldGet(this, _LoggingPipeline_bootstrapDropped, "f") > 0) {
+            __classPrivateFieldGet(this, _LoggingPipeline_drops, "f").record(PIPELINE_SINK_ID, "buffer_full", __classPrivateFieldGet(this, _LoggingPipeline_bootstrapDropped, "f"));
+            __classPrivateFieldSet(this, _LoggingPipeline_bootstrapDropped, 0, "f");
+        }
+        __classPrivateFieldSet(this, _LoggingPipeline_bootstrap, undefined, "f");
+    }
+    /**
+     * The severity at or above which a record is created for a scope at
+     * `scopeThreshold`: the minimum — most verbose — effective level across all
+     * attached sinks. A record failing this gate reaches no sink and is never
+     * created, formatted, or sent across an FFI boundary.
+     *
+     * With no sink attached the scope's own threshold governs, so records still
+     * reach the bootstrap buffer and are replayed once a sink arrives.
+     */
+    gateFor(scopeThreshold) {
+        const cached = __classPrivateFieldGet(this, _LoggingPipeline_gateCache, "f").get(scopeThreshold);
+        if (cached !== undefined)
+            return cached;
+        let gate = scopeThreshold;
+        if (__classPrivateFieldGet(this, _LoggingPipeline_sinks, "f").length > 0) {
+            gate = Number.POSITIVE_INFINITY;
+            for (const sink of __classPrivateFieldGet(this, _LoggingPipeline_sinks, "f")) {
+                const effective = Number.isFinite(sink.level) ? sink.level : scopeThreshold;
+                if (effective < gate)
+                    gate = effective;
+            }
+        }
+        __classPrivateFieldGet(this, _LoggingPipeline_gateCache, "f").set(scopeThreshold, gate);
+        return gate;
+    }
+    get gateVersion() {
+        return __classPrivateFieldGet(this, _LoggingPipeline_gateVersion, "f");
+    }
+    /** Count a drop against a sink. Exposed so a sink's own buffer can report
+     *  saturation without reaching into the registry directly. */
+    recordDrop(sinkId, cause, count = 1) {
+        __classPrivateFieldGet(this, _LoggingPipeline_drops, "f").record(sinkId, cause, count);
+    }
+    /** Lifetime drop total for a (sink, cause) pair, for assertions and for the
+     *  shutdown report. */
+    dropTotal(sinkId, cause) {
+        return __classPrivateFieldGet(this, _LoggingPipeline_drops, "f").total(sinkId, cause);
+    }
+    createLogger(scope, resource, bound) {
+        return new ScopedLogger(this, scope, resource, bound);
+    }
+    /** Build and dispatch a record. Never throws (§8.4). */
+    emit(scope, severity, message, resource, bound, attributes, options) {
+        try {
+            const record = __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_buildRecord).call(this, scope, severity, message, resource, bound, attributes, options);
+            const sampler = __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_samplerFor).call(this, scope);
+            if (sampler && !sampler.shouldEmit(record, Date.now())) {
+                __classPrivateFieldGet(this, _LoggingPipeline_drops, "f").record(PIPELINE_SINK_ID, "sampled");
+                return;
+            }
+            __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_dispatch).call(this, record);
+            // `fatal` never alters control flow — no exit, no panic — but it does
+            // oblige an immediate flush: synchronous on every sink that supports it,
+            // initiated without waiting on the rest (§10.5).
+            if (severity >= SEVERITY.fatal)
+                this.flushFatal();
+        }
+        catch (err) {
+            __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_reportFallback).call(this, "<pipeline>", err);
+        }
+    }
+    /** §10.5's fatal tiering: drain every sync-flushable sink to completion before
+     *  returning, and merely *initiate* the rest. Blocking on a sink that cannot
+     *  be synchronously drained is a deadlock on an event loop, not durability. */
+    flushFatal() {
+        for (const sink of __classPrivateFieldGet(this, _LoggingPipeline_sinks, "f")) {
+            try {
+                if (sink.syncFlushable)
+                    sink.flushSync();
+                else
+                    void sink.flush().catch((err) => __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_reportFallback).call(this, sink.sinkId, err));
+            }
+            catch (err) {
+                __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_reportFallback).call(this, sink.sinkId, err);
+            }
+        }
+    }
+    async flush() {
+        await Promise.all(__classPrivateFieldGet(this, _LoggingPipeline_sinks, "f").map((sink) => sink.flush().catch((err) => {
+            __classPrivateFieldGet(this, _LoggingPipeline_drops, "f").record(sink.sinkId, "sink_error");
+            __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_reportFallback).call(this, sink.sinkId, err);
+        })));
+    }
+    /** Final flush and release. Outstanding drop reports are emitted first so a
+     *  run that ends while still dropping does not lose its accounting. */
+    async close() {
+        __classPrivateFieldGet(this, _LoggingPipeline_drops, "f").reportPending();
+        await this.flush();
+        await Promise.all(__classPrivateFieldGet(this, _LoggingPipeline_sinks, "f").map((sink) => sink.close().catch((err) => __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_reportFallback).call(this, sink.sinkId, err))));
+        __classPrivateFieldGet(this, _LoggingPipeline_sinks, "f").length = 0;
+        __classPrivateFieldGet(this, _LoggingPipeline_drops, "f").dispose();
+        __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_invalidateGate).call(this);
+    }
+}
+_LoggingPipeline_sinks = new WeakMap(), _LoggingPipeline_drops = new WeakMap(), _LoggingPipeline_fallback = new WeakMap(), _LoggingPipeline_limits = new WeakMap(), _LoggingPipeline_bootstrapCapacity = new WeakMap(), _LoggingPipeline_traceContext = new WeakMap(), _LoggingPipeline_gateVersion = new WeakMap(), _LoggingPipeline_gateCache = new WeakMap(), _LoggingPipeline_bootstrap = new WeakMap(), _LoggingPipeline_bootstrapDropped = new WeakMap(), _LoggingPipeline_samplers = new WeakMap(), _LoggingPipeline_lastFallbackReport = new WeakMap(), _LoggingPipeline_instances = new WeakSet(), _LoggingPipeline_buildRecord = function _LoggingPipeline_buildRecord(scope, severity, message, resource, bound, attributes, options) {
+    const merged = bound || attributes || scope.attributes
+        ? { ...scope.attributes, ...bound, ...attributes }
+        : undefined;
+    const normalized = normalizeAttributes(merged, {
+        limits: __classPrivateFieldGet(this, _LoggingPipeline_limits, "f"),
+        secretValues: scope.secretValues,
+        censor: scope.redaction.censor,
+    });
+    redactAttributes(normalized.attributes, scope.redaction);
+    const error = options?.error === undefined ? undefined : toErrorValue(options.error);
+    redactError(error, scope.redaction);
+    const timestamp = options?.timestamp ?? nowUnixNano();
+    const record = {
+        timestamp,
+        severityNumber: severity,
+        severityText: options?.severityText ?? canonicalSeverityText(severity),
+        message,
+    };
+    // A bridged record's origin time precedes the moment the runtime saw it.
+    if (options?.timestamp !== undefined)
+        record.observedTimestamp = nowUnixNano();
+    if (normalized.attributes && Object.keys(normalized.attributes).length > 0) {
+        record.attributes = normalized.attributes;
+    }
+    if (normalized.droppedCount > 0)
+        record.droppedAttributesCount = normalized.droppedCount;
+    if (error)
+        record.error = error;
+    if (resource)
+        record.resource = resource;
+    if (scope.module)
+        record.module = scope.module;
+    if (scope.scope)
+        record.scope = scope.scope;
+    if (options?.eventName)
+        record.eventName = options.eventName.slice(0, 256);
+    const trace = __classPrivateFieldGet(this, _LoggingPipeline_traceContext, "f")?.call(this);
+    if (trace) {
+        record.traceId = trace.traceId;
+        record.spanId = trace.spanId;
+        if (trace.traceFlags !== undefined)
+            record.traceFlags = trace.traceFlags;
+    }
+    return record;
+}, _LoggingPipeline_dispatch = function _LoggingPipeline_dispatch(record) {
+    if (__classPrivateFieldGet(this, _LoggingPipeline_sinks, "f").length === 0) {
+        __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_bufferBootstrap).call(this, record);
+        return;
+    }
+    if (__classPrivateFieldGet(this, _LoggingPipeline_bootstrap, "f"))
+        __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_bufferBootstrap).call(this, record);
+    for (const sink of __classPrivateFieldGet(this, _LoggingPipeline_sinks, "f")) {
+        if (record.severityNumber < sink.level)
+            continue;
+        __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_writeTo).call(this, sink, record);
+    }
+}, _LoggingPipeline_writeTo = function _LoggingPipeline_writeTo(sink, record) {
+    try {
+        sink.write(record);
+    }
+    catch (err) {
+        __classPrivateFieldGet(this, _LoggingPipeline_drops, "f").record(sink.sinkId, "sink_error");
+        __classPrivateFieldGet(this, _LoggingPipeline_instances, "m", _LoggingPipeline_reportFallback).call(this, sink.sinkId, err);
+    }
+}, _LoggingPipeline_bufferBootstrap = function _LoggingPipeline_bufferBootstrap(record) {
+    const buffer = __classPrivateFieldGet(this, _LoggingPipeline_bootstrap, "f");
+    if (!buffer)
+        return;
+    if (buffer.length >= __classPrivateFieldGet(this, _LoggingPipeline_bootstrapCapacity, "f")) {
+        __classPrivateFieldSet(this, _LoggingPipeline_bootstrapDropped, __classPrivateFieldGet(this, _LoggingPipeline_bootstrapDropped, "f") + 1, "f");
+        return;
+    }
+    buffer.push(record);
+}, _LoggingPipeline_samplerFor = function _LoggingPipeline_samplerFor(scope) {
+    if (!scope.sampling)
+        return undefined;
+    let sampler = __classPrivateFieldGet(this, _LoggingPipeline_samplers, "f").get(scope);
+    if (!sampler) {
+        sampler = new Sampler(scope.sampling);
+        __classPrivateFieldGet(this, _LoggingPipeline_samplers, "f").set(scope, sampler);
+    }
+    return sampler;
+}, _LoggingPipeline_invalidateGate = function _LoggingPipeline_invalidateGate() {
+    __classPrivateFieldSet(this, _LoggingPipeline_gateVersion, __classPrivateFieldGet(this, _LoggingPipeline_gateVersion, "f") + 1, "f");
+    __classPrivateFieldSet(this, _LoggingPipeline_gateCache, new Map(), "f");
+}, _LoggingPipeline_reportDrops = function _LoggingPipeline_reportDrops(report) {
+    this.emit(ROOT_SCOPE_CONFIG, SEVERITY.warn, `dropped ${report.count} log record(s)`, undefined, undefined, {
+        "telo.log.sink": report.sinkId,
+        "telo.log.drop_cause": report.cause,
+        "telo.log.dropped": report.count,
+        "telo.log.dropped_total": report.total,
+    }, { eventName: "telo.log.dropped" });
+}, _LoggingPipeline_reportFallback = function _LoggingPipeline_reportFallback(sinkId, err) {
+    const now = Date.now();
+    const last = __classPrivateFieldGet(this, _LoggingPipeline_lastFallbackReport, "f").get(sinkId) ?? 0;
+    if (now - last < FALLBACK_REPORT_INTERVAL_MS)
+        return;
+    __classPrivateFieldGet(this, _LoggingPipeline_lastFallbackReport, "f").set(sinkId, now);
+    const detail = err instanceof Error ? `${err.name}: ${err.message}` : String(err);
+    try {
+        __classPrivateFieldGet(this, _LoggingPipeline_fallback, "f").write(`[telo:logging] sink "${sinkId}" failed: ${detail}\n`);
+    }
+    catch {
+        // The fallback stream itself is gone. There is nowhere left to report to,
+        // and throwing here would break the application — which §8.4 forbids.
+    }
+};
+class ScopedLogger {
+    constructor(pipeline, scope, resource, bound) {
+        _ScopedLogger_pipeline.set(this, void 0);
+        _ScopedLogger_scope.set(this, void 0);
+        _ScopedLogger_resource.set(this, void 0);
+        _ScopedLogger_bound.set(this, void 0);
+        _ScopedLogger_cachedGate.set(this, Number.NaN);
+        _ScopedLogger_cachedVersion.set(this, -1);
+        __classPrivateFieldSet(this, _ScopedLogger_pipeline, pipeline, "f");
+        __classPrivateFieldSet(this, _ScopedLogger_scope, scope, "f");
+        __classPrivateFieldSet(this, _ScopedLogger_resource, resource, "f");
+        __classPrivateFieldSet(this, _ScopedLogger_bound, bound, "f");
+    }
+    enabled(severity) {
+        const version = __classPrivateFieldGet(this, _ScopedLogger_pipeline, "f").gateVersion;
+        if (version !== __classPrivateFieldGet(this, _ScopedLogger_cachedVersion, "f")) {
+            __classPrivateFieldSet(this, _ScopedLogger_cachedGate, __classPrivateFieldGet(this, _ScopedLogger_pipeline, "f").gateFor(__classPrivateFieldGet(this, _ScopedLogger_scope, "f").threshold), "f");
+            __classPrivateFieldSet(this, _ScopedLogger_cachedVersion, version, "f");
+        }
+        return severity >= __classPrivateFieldGet(this, _ScopedLogger_cachedGate, "f");
+    }
+    log(severity, message, attributes, options) {
+        if (!this.enabled(severity))
+            return;
+        __classPrivateFieldGet(this, _ScopedLogger_pipeline, "f").emit(__classPrivateFieldGet(this, _ScopedLogger_scope, "f"), severity, message, __classPrivateFieldGet(this, _ScopedLogger_resource, "f"), __classPrivateFieldGet(this, _ScopedLogger_bound, "f"), attributes, options);
+    }
+    /** Binding merges once, here — never per record — so a child logger costs one
+     *  spread at creation and nothing at emit time (§8.3). */
+    with(attributes) {
+        const normalized = normalizeAttributes(attributes).attributes;
+        return new ScopedLogger(__classPrivateFieldGet(this, _ScopedLogger_pipeline, "f"), __classPrivateFieldGet(this, _ScopedLogger_scope, "f"), __classPrivateFieldGet(this, _ScopedLogger_resource, "f"), {
+            ...__classPrivateFieldGet(this, _ScopedLogger_bound, "f"),
+            ...normalized,
+        });
+    }
+    flush() {
+        return __classPrivateFieldGet(this, _ScopedLogger_pipeline, "f").flush();
+    }
+    trace(message, attributes, options) {
+        this.log(SEVERITY.trace, message, attributes, options);
+    }
+    debug(message, attributes, options) {
+        this.log(SEVERITY.debug, message, attributes, options);
+    }
+    info(message, attributes, options) {
+        this.log(SEVERITY.info, message, attributes, options);
+    }
+    warn(message, attributes, options) {
+        this.log(SEVERITY.warn, message, attributes, options);
+    }
+    error(message, attributes, options) {
+        this.log(SEVERITY.error, message, attributes, options);
+    }
+    fatal(message, attributes, options) {
+        this.log(SEVERITY.fatal, message, attributes, options);
+    }
+}
+_ScopedLogger_pipeline = new WeakMap(), _ScopedLogger_scope = new WeakMap(), _ScopedLogger_resource = new WeakMap(), _ScopedLogger_bound = new WeakMap(), _ScopedLogger_cachedGate = new WeakMap(), _ScopedLogger_cachedVersion = new WeakMap();
+//# sourceMappingURL=logging-pipeline.js.map

package/dist/logging/logging-pipeline.js.map

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

package/dist/logging/normalize-attributes.d.ts

@@ -0,0 +1,48 @@
+import { type LogAttributes, type LogAttributesInput } from "@telorun/sdk";
+/**
+ * Attribute normalization — `kernel/specs/logging.md` §6.3.
+ *
+ * Resolves deferred values, applies every limit, scrubs secret values, and
+ * detects cycles in a single traversal. The caps are not optional hardening:
+ * they bound the blast radius of a redaction miss and of a cyclic or
+ * pathological value graph, so the traversal is iterative with a bounded
+ * counter rather than recursive, and an exception raised inside a user-supplied
+ * deferred value is caught and rendered as a diagnostic string rather than
+ * propagated (§8.4 — a logging call never throws).
+ *
+ * Secret scrubbing happens here rather than in the path-based pass because this
+ * traversal already visits every node, and §14 requires manifest secrets to
+ * redact with no configuration at all.
+ */
+export interface AttributeLimits {
+    /** Excess attributes are dropped and counted into `dropped_attributes_count`. */
+    attributeCount: number;
+    /** Unlimited when `undefined`; when set, longer strings truncate and are marked. */
+    valueLength?: number;
+    /** Over-deep subtrees are replaced with `"[depth exceeded]"`. */
+    depth: number;
+    /** Arrays and maps truncate, recording the original length. */
+    collectionElements: number;
+    /** Deferred-value resolutions per record. Beyond this the traversal stops
+     *  resolving and substitutes a diagnostic string. */
+    deferredSteps: number;
+}
+export declare const DEFAULT_ATTRIBUTE_LIMITS: AttributeLimits;
+export declare const DEPTH_EXCEEDED = "[depth exceeded]";
+export declare const CIRCULAR = "[circular]";
+export interface NormalizeOptions {
+    limits?: AttributeLimits;
+    /** Exact string values to replace with the censor token. Sourced from the
+     *  emitting module context's resolved `secrets:`, so redaction follows the
+     *  same cascade the threshold does. */
+    secretValues?: ReadonlySet<string>;
+    censor?: string;
+}
+export interface NormalizedAttributes {
+    attributes: LogAttributes | undefined;
+    /** Non-zero when limits truncated attributes; emitted as
+     *  `dropped_attributes_count` and omitted when zero. */
+    droppedCount: number;
+}
+export declare function normalizeAttributes(input: LogAttributesInput | undefined, options?: NormalizeOptions): NormalizedAttributes;
+//# sourceMappingURL=normalize-attributes.d.ts.map

package/dist/logging/normalize-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-attributes.d.ts","sourceRoot":"","sources":["../../src/logging/normalize-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvG;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,cAAc,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,kBAAkB,EAAE,MAAM,CAAC;IAC3B;yDACqD;IACrD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,wBAAwB,EAAE,eAMtC,CAAC;AAEF,eAAO,MAAM,cAAc,qBAAqB,CAAC;AACjD,eAAO,MAAM,QAAQ,eAAe,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;;2CAEuC;IACvC,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,aAAa,GAAG,SAAS,CAAC;IACtC;4DACwD;IACxD,YAAY,EAAE,MAAM,CAAC;CACtB;AAgBD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,OAAO,GAAE,gBAAqB,GAC7B,oBAAoB,CAkItB"}