@telorun/kernel 0.48.0 → 0.50.0

package/dist/logging/console-sink.js

@@ -0,0 +1,56 @@
+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 _ConsoleSink_stream, _ConsoleSink_pretty, _ConsoleSink_color, _ConsoleSink_encodeBytes;
+import { decideColor } from "./color-precedence.js";
+import { encodeJsonLine } from "./encode-json.js";
+import { encodePrettyLine } from "./encode-pretty.js";
+export class ConsoleSink {
+    constructor(options) {
+        /** A file-descriptor write blocks until the bytes are handed to the OS, so a
+         *  `fatal` record is durable by the time `log()` returns (§10.5). */
+        this.syncFlushable = true;
+        _ConsoleSink_stream.set(this, void 0);
+        _ConsoleSink_pretty.set(this, void 0);
+        _ConsoleSink_color.set(this, void 0);
+        _ConsoleSink_encodeBytes.set(this, void 0);
+        this.sinkId = options.sinkId;
+        this.level = options.level;
+        const destination = options.destination ?? "stderr";
+        __classPrivateFieldSet(this, _ConsoleSink_stream, destination === "stdout" ? options.stdout : options.stderr, "f");
+        // `auto` is evaluated against *this sink's* destination descriptor, not the
+        // process's: a console sink on stdout and another on stderr can resolve
+        // differently, and that is correct.
+        const isTTY = Boolean(__classPrivateFieldGet(this, _ConsoleSink_stream, "f").isTTY);
+        const encoding = options.encoding ?? "auto";
+        __classPrivateFieldSet(this, _ConsoleSink_pretty, encoding === "pretty" || (encoding === "auto" && isTTY), "f");
+        __classPrivateFieldSet(this, _ConsoleSink_color, __classPrivateFieldGet(this, _ConsoleSink_pretty, "f")
+            ? decideColor({ setting: options.color ?? "auto", env: options.env, isTTY })
+            : false, "f");
+        __classPrivateFieldSet(this, _ConsoleSink_encodeBytes, options.encodeBytes, "f");
+    }
+    write(record) {
+        __classPrivateFieldGet(this, _ConsoleSink_stream, "f").write(__classPrivateFieldGet(this, _ConsoleSink_pretty, "f")
+            ? encodePrettyLine(record, { color: __classPrivateFieldGet(this, _ConsoleSink_color, "f") })
+            : encodeJsonLine(record, { encodeBytes: __classPrivateFieldGet(this, _ConsoleSink_encodeBytes, "f") }));
+    }
+    async flush() {
+        // Nothing is held: every record is handed to the descriptor on write.
+    }
+    flushSync() {
+        // Same — the write already reached the OS.
+    }
+    async close() {
+        // The process owns stdout/stderr; a sink never closes them.
+    }
+}
+_ConsoleSink_stream = new WeakMap(), _ConsoleSink_pretty = new WeakMap(), _ConsoleSink_color = new WeakMap(), _ConsoleSink_encodeBytes = new WeakMap();
+//# sourceMappingURL=console-sink.js.map

package/dist/logging/console-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-sink.js","sourceRoot":"","sources":["../../src/logging/console-sink.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,OAAO,EAAE,WAAW,EAAqB,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAqB,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAiCtD,MAAM,OAAO,WAAW;IAYtB,YAAY,OAA2B;QATvC;6EACqE;QAC5D,kBAAa,GAAG,IAAI,CAAC;QAErB,sCAA+B;QAC/B,sCAAiB;QACjB,qCAAgB;QAChB,2CAAuC;QAG9C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,QAAQ,CAAC;QACpD,uBAAA,IAAI,uBAAW,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,MAAA,CAAC;QAE1E,4EAA4E;QAC5E,wEAAwE;QACxE,oCAAoC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAE,uBAAA,IAAI,2BAAgC,CAAC,KAAK,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC;QAC5C,uBAAA,IAAI,uBAAW,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,KAAK,MAAM,IAAI,KAAK,CAAC,MAAA,CAAC;QACvE,uBAAA,IAAI,sBAAU,uBAAA,IAAI,2BAAQ;YACxB,CAAC,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;YAC5E,CAAC,CAAC,KAAK,MAAA,CAAC;QACV,uBAAA,IAAI,4BAAgB,OAAO,CAAC,WAAW,MAAA,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAiB;QACrB,uBAAA,IAAI,2BAAQ,CAAC,KAAK,CAChB,uBAAA,IAAI,2BAAQ;YACV,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,uBAAA,IAAI,0BAAO,EAAE,CAAC;YAClD,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,uBAAA,IAAI,gCAAa,EAAE,CAAC,CAC/D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,sEAAsE;IACxE,CAAC;IAED,SAAS;QACP,2CAA2C;IAC7C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,4DAA4D;IAC9D,CAAC;CACF"}

package/dist/logging/debug-wire-sink.d.ts

@@ -0,0 +1,38 @@
+import type { LogRecord } from "@telorun/sdk";
+import { type BytesEncoder } from "./encode-json.js";
+import type { LogSinkInstance } from "./log-sink.js";
+/**
+ * The `debug-wire` sink — `kernel/specs/logging.md` §10.2 and §11.4.
+ *
+ * **Not declarable.** It is host-attached when a debug consumer connects
+ * (`--debug` / `--inspect`) and detached on disconnect, which makes it tooling
+ * attachment rather than application configuration — the same category as TTY
+ * detection, not a violation of D6.
+ *
+ * Not sync-flushable: delivery crosses an SSE/stream boundary owned by the host,
+ * so a `fatal` record's flush here is initiated but never awaited (§10.5).
+ */
+export declare const DEBUG_WIRE_SINK_ID = "<debug-wire>";
+export declare class DebugWireSink implements LogSinkInstance {
+    #private;
+    readonly sinkId = "<debug-wire>";
+    readonly level: number;
+    readonly syncFlushable = false;
+    constructor(options: {
+        level: number;
+        /** Hands a §11.4 `record` frame to the host's wire writer. */
+        emit: (frame: {
+            kind: "record";
+            timestamp: string;
+            record: Record<string, unknown>;
+        }) => void;
+        /** Offloads `bytes` attributes to the host's blob store when it has one —
+         *  the debug wire does. Raw bytes are never inlined (§6.1). */
+        encodeBytes?: BytesEncoder;
+    });
+    write(record: LogRecord): void;
+    flush(): Promise<void>;
+    flushSync(): void;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=debug-wire-sink.d.ts.map

package/dist/logging/debug-wire-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-wire-sink.d.ts","sourceRoot":"","sources":["../../src/logging/debug-wire-sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD,qBAAa,aAAc,YAAW,eAAe;;IACnD,QAAQ,CAAC,MAAM,kBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,SAAS;gBAKnB,OAAO,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,8DAA8D;QAC9D,IAAI,EAAE,CAAC,KAAK,EAAE;YAAE,IAAI,EAAE,QAAQ,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,KAAK,IAAI,CAAC;QAC9F;uEAC+D;QAC/D,WAAW,CAAC,EAAE,YAAY,CAAC;KAC5B;IAMD,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAUxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,SAAS,IAAI,IAAI;IAIX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAC7B"}

package/dist/logging/debug-wire-sink.js

@@ -0,0 +1,85 @@
+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 _DebugWireSink_emit, _DebugWireSink_encodeBytes;
+import { toJsonProfile } from "./encode-json.js";
+/**
+ * The `debug-wire` sink — `kernel/specs/logging.md` §10.2 and §11.4.
+ *
+ * **Not declarable.** It is host-attached when a debug consumer connects
+ * (`--debug` / `--inspect`) and detached on disconnect, which makes it tooling
+ * attachment rather than application configuration — the same category as TTY
+ * detection, not a violation of D6.
+ *
+ * Not sync-flushable: delivery crosses an SSE/stream boundary owned by the host,
+ * so a `fatal` record's flush here is initiated but never awaited (§10.5).
+ */
+export const DEBUG_WIRE_SINK_ID = "<debug-wire>";
+export class DebugWireSink {
+    constructor(options) {
+        this.sinkId = DEBUG_WIRE_SINK_ID;
+        this.syncFlushable = false;
+        _DebugWireSink_emit.set(this, void 0);
+        _DebugWireSink_encodeBytes.set(this, void 0);
+        this.level = options.level;
+        __classPrivateFieldSet(this, _DebugWireSink_emit, options.emit, "f");
+        __classPrivateFieldSet(this, _DebugWireSink_encodeBytes, options.encodeBytes, "f");
+    }
+    write(record) {
+        const profile = toJsonProfile(record);
+        if (__classPrivateFieldGet(this, _DebugWireSink_encodeBytes, "f"))
+            offloadBytes(profile, __classPrivateFieldGet(this, _DebugWireSink_encodeBytes, "f"));
+        __classPrivateFieldGet(this, _DebugWireSink_emit, "f").call(this, {
+            kind: "record",
+            timestamp: new Date(Number(record.timestamp / 1000000n)).toISOString(),
+            record: profile,
+        });
+    }
+    async flush() {
+        // Frames are handed to the host synchronously; the host owns delivery.
+    }
+    flushSync() {
+        // Never synchronously drainable — see the class doc.
+    }
+    async close() { }
+}
+_DebugWireSink_emit = new WeakMap(), _DebugWireSink_encodeBytes = new WeakMap();
+/** Replace `Uint8Array` leaves with the host's pointer form, bounded by the
+ *  attribute limits already applied upstream. */
+function offloadBytes(value, encodeBytes) {
+    const stack = [value];
+    let guard = 0;
+    while (stack.length > 0 && guard < 10000) {
+        guard += 1;
+        const current = stack.pop();
+        if (!current || typeof current !== "object")
+            continue;
+        if (Array.isArray(current)) {
+            for (let i = 0; i < current.length; i += 1) {
+                const item = current[i];
+                if (item instanceof Uint8Array)
+                    current[i] = encodeBytes(item);
+                else
+                    stack.push(item);
+            }
+            continue;
+        }
+        const record = current;
+        for (const key of Object.keys(record)) {
+            const item = record[key];
+            if (item instanceof Uint8Array)
+                record[key] = encodeBytes(item);
+            else
+                stack.push(item);
+        }
+    }
+}
+//# sourceMappingURL=debug-wire-sink.js.map

package/dist/logging/debug-wire-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-wire-sink.js","sourceRoot":"","sources":["../../src/logging/debug-wire-sink.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,OAAO,EAAE,aAAa,EAAqB,MAAM,kBAAkB,CAAC;AAGpE;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAEjD,MAAM,OAAO,aAAa;IAQxB,YAAY,OAOX;QAdQ,WAAM,GAAG,kBAAkB,CAAC;QAE5B,kBAAa,GAAG,KAAK,CAAC;QAEtB,sCAA+F;QAC/F,6CAAuC;QAU9C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,uBAAA,IAAI,uBAAS,OAAO,CAAC,IAAI,MAAA,CAAC;QAC1B,uBAAA,IAAI,8BAAgB,OAAO,CAAC,WAAW,MAAA,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAiB;QACrB,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,uBAAA,IAAI,kCAAa;YAAE,YAAY,CAAC,OAAO,EAAE,uBAAA,IAAI,kCAAa,CAAC,CAAC;QAChE,uBAAA,IAAI,2BAAM,MAAV,IAAI,EAAO;YACT,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,GAAG,QAAU,CAAC,CAAC,CAAC,WAAW,EAAE;YACxE,MAAM,EAAE,OAAO;SAChB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,uEAAuE;IACzE,CAAC;IAED,SAAS;QACP,qDAAqD;IACvD,CAAC;IAED,KAAK,CAAC,KAAK,KAAmB,CAAC;CAChC;;AAED;iDACiD;AACjD,SAAS,YAAY,CAAC,KAAc,EAAE,WAAyB;IAC7D,MAAM,KAAK,GAAc,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,GAAG,KAAM,EAAE,CAAC;QAC1C,KAAK,IAAI,CAAC,CAAC;QACX,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,SAAS;QACtD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBACxB,IAAI,IAAI,YAAY,UAAU;oBAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;;oBAC1D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,OAAkC,CAAC;QAClD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,IAAI,YAAY,UAAU;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;;gBAC3D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/logging/drop-accounting.d.ts

@@ -0,0 +1,34 @@
+import type { DropCause } from "./log-sink.js";
+/**
+ * Drop accounting — `kernel/specs/logging.md` §10.4.
+ *
+ * A runtime maintains a monotonic counter of records dropped per sink, per
+ * cause. When drops occur and then cease, it emits exactly one `warn` record
+ * reporting the count and the cause. **Dropping without accounting is
+ * non-conformant** — "nothing is silently lost" is a design principle, not a
+ * nice-to-have, so every drop, truncation, and sink failure is counted and
+ * surfaced.
+ */
+/** Sampling drops happen before fan-out, so they are not attributable to any one
+ *  sink and are counted against the pipeline itself. */
+export declare const PIPELINE_SINK_ID = "<pipeline>";
+export interface DropReport {
+    sinkId: string;
+    cause: DropCause;
+    /** Records dropped since the previous report. */
+    count: number;
+    /** Monotonic lifetime total for this (sink, cause) pair. */
+    total: number;
+}
+export declare class DropRegistry {
+    #private;
+    constructor(onRecovered: (report: DropReport) => void);
+    record(sinkId: string, cause: DropCause, count?: number): void;
+    /** Lifetime total for a (sink, cause) pair. */
+    total(sinkId: string, cause: DropCause): number;
+    /** Emit any outstanding reports immediately — used at shutdown so a run that
+     *  ends while still dropping does not lose its final accounting. */
+    reportPending(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=drop-accounting.d.ts.map

package/dist/logging/drop-accounting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-accounting.d.ts","sourceRoot":"","sources":["../../src/logging/drop-accounting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;GASG;AAEH;wDACwD;AACxD,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAa7C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,YAAY;;gBAOX,WAAW,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI;IAIrD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,SAAI,GAAG,IAAI;IAyBzD,+CAA+C;IAC/C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM;IAI/C;wEACoE;IACpE,aAAa,IAAI,IAAI;IAQrB,OAAO,IAAI,IAAI;CAmBhB"}

package/dist/logging/drop-accounting.js

@@ -0,0 +1,98 @@
+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 _DropRegistry_instances, _DropRegistry_counters, _DropRegistry_onRecovered, _DropRegistry_reporting, _DropRegistry_report;
+/**
+ * Drop accounting — `kernel/specs/logging.md` §10.4.
+ *
+ * A runtime maintains a monotonic counter of records dropped per sink, per
+ * cause. When drops occur and then cease, it emits exactly one `warn` record
+ * reporting the count and the cause. **Dropping without accounting is
+ * non-conformant** — "nothing is silently lost" is a design principle, not a
+ * nice-to-have, so every drop, truncation, and sink failure is counted and
+ * surfaced.
+ */
+/** Sampling drops happen before fan-out, so they are not attributable to any one
+ *  sink and are counted against the pipeline itself. */
+export const PIPELINE_SINK_ID = "<pipeline>";
+/** How long a cause must go quiet before its recovery warning is emitted. */
+const QUIESCE_MS = 1000;
+export class DropRegistry {
+    constructor(onRecovered) {
+        _DropRegistry_instances.add(this);
+        _DropRegistry_counters.set(this, new Map());
+        _DropRegistry_onRecovered.set(this, void 0);
+        /** Guards against a recovery warning that itself drops, which would otherwise
+         *  re-arm the timer forever. */
+        _DropRegistry_reporting.set(this, false);
+        __classPrivateFieldSet(this, _DropRegistry_onRecovered, onRecovered, "f");
+    }
+    record(sinkId, cause, count = 1) {
+        const key = `${sinkId}\x00${cause}`;
+        let counter = __classPrivateFieldGet(this, _DropRegistry_counters, "f").get(key);
+        if (!counter) {
+            counter = { total: 0, reported: 0, timer: undefined };
+            __classPrivateFieldGet(this, _DropRegistry_counters, "f").set(key, counter);
+        }
+        // Always count — a drop caused by emitting the recovery warning itself is
+        // still a drop, and undercounting it is exactly the silent loss this class
+        // exists to prevent.
+        counter.total += count;
+        // The only thing suppressed while a recovery warning is in flight is the
+        // timer re-arm: re-arming here would loop forever (the warning's own drop
+        // re-arms the timer, which fires and drops again). The increment above keeps
+        // the total honest; the next ordinary drop — or `reportPending` at
+        // shutdown — surfaces it, since `total !== reported`.
+        if (__classPrivateFieldGet(this, _DropRegistry_reporting, "f"))
+            return;
+        if (counter.timer)
+            clearTimeout(counter.timer);
+        counter.timer = setTimeout(() => __classPrivateFieldGet(this, _DropRegistry_instances, "m", _DropRegistry_report).call(this, sinkId, cause, counter), QUIESCE_MS);
+        // A pending drop report must never be the reason a process stays alive.
+        counter.timer.unref?.();
+    }
+    /** Lifetime total for a (sink, cause) pair. */
+    total(sinkId, cause) {
+        return __classPrivateFieldGet(this, _DropRegistry_counters, "f").get(`${sinkId}\x00${cause}`)?.total ?? 0;
+    }
+    /** Emit any outstanding reports immediately — used at shutdown so a run that
+     *  ends while still dropping does not lose its final accounting. */
+    reportPending() {
+        for (const [key, counter] of __classPrivateFieldGet(this, _DropRegistry_counters, "f")) {
+            if (counter.total === counter.reported)
+                continue;
+            const [sinkId, cause] = key.split("\x00");
+            __classPrivateFieldGet(this, _DropRegistry_instances, "m", _DropRegistry_report).call(this, sinkId, cause, counter);
+        }
+    }
+    dispose() {
+        for (const counter of __classPrivateFieldGet(this, _DropRegistry_counters, "f").values()) {
+            if (counter.timer)
+                clearTimeout(counter.timer);
+            counter.timer = undefined;
+        }
+    }
+}
+_DropRegistry_counters = new WeakMap(), _DropRegistry_onRecovered = new WeakMap(), _DropRegistry_reporting = new WeakMap(), _DropRegistry_instances = new WeakSet(), _DropRegistry_report = function _DropRegistry_report(sinkId, cause, counter) {
+    counter.timer = undefined;
+    const count = counter.total - counter.reported;
+    if (count <= 0)
+        return;
+    counter.reported = counter.total;
+    __classPrivateFieldSet(this, _DropRegistry_reporting, true, "f");
+    try {
+        __classPrivateFieldGet(this, _DropRegistry_onRecovered, "f").call(this, { sinkId, cause, count, total: counter.total });
+    }
+    finally {
+        __classPrivateFieldSet(this, _DropRegistry_reporting, false, "f");
+    }
+};
+//# sourceMappingURL=drop-accounting.js.map

package/dist/logging/drop-accounting.js.map

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

package/dist/logging/encode-json.d.ts

@@ -0,0 +1,28 @@
+import { type AnyValue, type LogRecord } from "@telorun/sdk";
+/**
+ * The `json` encoding — `kernel/specs/logging.md` §11.1. One JSON object per
+ * line, UTF-8, newline-terminated.
+ *
+ * No de-facto cross-ecosystem standard exists for key names, so Telo defines its
+ * own profile and keeps OTLP as a separate one. Keys are emitted in the §11.1
+ * order for diffability, and extension data belongs in `attributes` — unknown
+ * top-level keys are never emitted.
+ */
+/** How a `bytes` attribute is rendered. Raw bytes are never inlined into a text
+ *  encoding: a sink with a blob store offloads them to a pointer, and every
+ *  other sink base64-encodes (§6.1). */
+export type BytesEncoder = (bytes: Uint8Array) => AnyValue;
+export declare const base64Bytes: BytesEncoder;
+export interface JsonEncodeOptions {
+    encodeBytes?: BytesEncoder;
+}
+/** Encode one record as a newline-terminated JSON line. */
+export declare function encodeJsonLine(record: LogRecord, options?: JsonEncodeOptions): string;
+/** Encode one record as a JSON object, without the trailing newline — the shape
+ *  the debug wire nests inside its `record` frame (§11.4). */
+export declare function encodeJson(record: LogRecord, options?: JsonEncodeOptions): string;
+/** The §11.1 key profile as a plain object, in the recommended order. Exposed
+ *  separately because the debug wire embeds the same profile rather than
+ *  re-deriving it. */
+export declare function toJsonProfile(record: LogRecord): Record<string, unknown>;
+//# sourceMappingURL=encode-json.d.ts.map

package/dist/logging/encode-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-json.d.ts","sourceRoot":"","sources":["../../src/logging/encode-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAmB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9F;;;;;;;;GAQG;AAEH;;wCAEwC;AACxC,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,QAAQ,CAAC;AAE3D,eAAO,MAAM,WAAW,EAAE,YAA+D,CAAC;AAE1F,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAEzF;AAED;8DAC8D;AAC9D,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAErF;AAED;;sBAEsB;AACtB,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+BxE"}

package/dist/logging/encode-json.js

@@ -0,0 +1,86 @@
+import { formatUnixNano } from "@telorun/sdk";
+export const base64Bytes = (bytes) => Buffer.from(bytes).toString("base64");
+/** Encode one record as a newline-terminated JSON line. */
+export function encodeJsonLine(record, options = {}) {
+    return `${encodeJson(record, options)}\n`;
+}
+/** Encode one record as a JSON object, without the trailing newline — the shape
+ *  the debug wire nests inside its `record` frame (§11.4). */
+export function encodeJson(record, options = {}) {
+    return JSON.stringify(toJsonProfile(record), makeReplacer(options.encodeBytes ?? base64Bytes));
+}
+/** The §11.1 key profile as a plain object, in the recommended order. Exposed
+ *  separately because the debug wire embeds the same profile rather than
+ *  re-deriving it. */
+export function toJsonProfile(record) {
+    const out = {
+        time: formatUnixNano(record.timestamp),
+        level: record.severityText.toUpperCase(),
+        severity: record.severityNumber,
+        msg: record.message,
+    };
+    // `observed_timestamp` is deliberately NOT emitted: §11.1 defines a closed key
+    // set and forbids extra top-level keys, and §17's schema is
+    // `additionalProperties: false`. The field survives on the record model and in
+    // the `otlp` profile, which has a real `observedTimeUnixNano` slot for it.
+    if (record.traceId !== undefined)
+        out["trace_id"] = record.traceId;
+    if (record.spanId !== undefined)
+        out["span_id"] = record.spanId;
+    if (record.traceFlags !== undefined)
+        out["trace_flags"] = record.traceFlags;
+    if (record.resource !== undefined)
+        out["resource"] = record.resource;
+    if (record.module !== undefined)
+        out["module"] = record.module;
+    if (record.scope !== undefined)
+        out["scope"] = record.scope;
+    // Nested, never flattened — flattening risks collision with reserved keys.
+    // Emitted with keys in sorted (code-point) order so the `json` encoding is
+    // byte-identical across runtimes (§16 vector 18): attribute keys are arbitrary
+    // user data with no natural order, and sorted is the only order both this
+    // runtime and a Rust `BTreeMap`-backed one produce without extra config.
+    if (record.attributes !== undefined)
+        out["attributes"] = sortKeysDeep(record.attributes);
+    if (record.error !== undefined)
+        out["err"] = record.error;
+    if (record.eventName !== undefined)
+        out["event_name"] = record.eventName;
+    if (record.droppedAttributesCount) {
+        out["dropped_attributes_count"] = record.droppedAttributesCount;
+    }
+    return out;
+}
+/** Rebuild an attribute value with every nested object's keys in sorted order.
+ *  `JSON.stringify` emits string keys in insertion order, so reconstructing the
+ *  object with sorted insertion is what pins the byte order. Arrays keep their
+ *  index order; `Uint8Array` is a leaf. The attributes are already normalized
+ *  (§6.3), so depth and breadth are bounded and this cannot diverge. */
+function sortKeysDeep(value) {
+    if (value === null || typeof value !== "object")
+        return value;
+    if (value instanceof Uint8Array)
+        return value;
+    if (Array.isArray(value))
+        return value.map(sortKeysDeep);
+    const sorted = {};
+    for (const key of Object.keys(value).sort())
+        sorted[key] = sortKeysDeep(value[key]);
+    return sorted;
+}
+function makeReplacer(encodeBytes) {
+    return function replacer(_key, value) {
+        if (typeof value === "bigint") {
+            // Values beyond 2^53 lose precision in a JS receiver, so they degrade to a
+            // decimal string rather than to a wrong number — the same reasoning OTLP
+            // gives for quoting its 64-bit fields.
+            return value >= BigInt(Number.MIN_SAFE_INTEGER) && value <= BigInt(Number.MAX_SAFE_INTEGER)
+                ? Number(value)
+                : value.toString();
+        }
+        if (value instanceof Uint8Array)
+            return encodeBytes(value);
+        return value;
+    };
+}
+//# sourceMappingURL=encode-json.js.map

package/dist/logging/encode-json.js.map

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

package/dist/logging/encode-pretty.d.ts

@@ -0,0 +1,7 @@
+import { type LogRecord } from "@telorun/sdk";
+export interface PrettyEncodeOptions {
+    color: boolean;
+}
+export declare function encodePrettyLine(record: LogRecord, options: PrettyEncodeOptions): string;
+export declare function encodePretty(record: LogRecord, options: PrettyEncodeOptions): string;
+//# sourceMappingURL=encode-pretty.d.ts.map

package/dist/logging/encode-pretty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-pretty.d.ts","sourceRoot":"","sources":["../../src/logging/encode-pretty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AA2B7F,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAExF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,GAAG,MAAM,CA+BpF"}

package/dist/logging/encode-pretty.js

@@ -0,0 +1,104 @@
+import { severityFloor } from "@telorun/sdk";
+/**
+ * The `pretty` encoding — `kernel/specs/logging.md` §11.2. For humans on a
+ * terminal:
+ *
+ *     12:34:56.789 INFO  Http.Server.api  listening  net.host.port=8080
+ *
+ * The color table is a modal synthesis across pino-pretty, zap, tint,
+ * tracing-subscriber, consola, and winston, which do not fully agree — zap alone
+ * uses magenta for DEBUG and blue for INFO, and TRACE has no consensus. It is a
+ * deliberate choice, not a standard.
+ */
+const RESET = "\u001b[0m";
+const LEVEL_COLOR = {
+    1: "\u001b[2m", // TRACE — dim
+    5: "\u001b[34m", // DEBUG — blue
+    9: "\u001b[32m", // INFO — green
+    13: "\u001b[33m", // WARN — yellow
+    17: "\u001b[31m", // ERROR — red
+    21: "\u001b[1;41m", // FATAL — bold, red background
+};
+const DIM = "\u001b[2m";
+export function encodePrettyLine(record, options) {
+    return `${encodePretty(record, options)}\n`;
+}
+export function encodePretty(record, options) {
+    const paint = options.color
+        ? (code, text) => `${code}${text}${RESET}`
+        : (_code, text) => text;
+    const parts = [
+        formatLocalTime(record.timestamp),
+        paint(LEVEL_COLOR[severityFloor(record.severityNumber)], record.severityText.padEnd(5)),
+    ];
+    if (record.resource)
+        parts.push(`${record.resource.kind}.${record.resource.name}`);
+    // The message itself is never colored by level — only the level token is.
+    parts.push(record.message);
+    const attributes = record.attributes;
+    if (attributes) {
+        for (const [key, value] of Object.entries(attributes)) {
+            parts.push(`${paint(DIM, key)}=${formatAttributeValue(value)}`);
+        }
+    }
+    if (record.droppedAttributesCount) {
+        parts.push(`${paint(DIM, "dropped_attributes_count")}=${record.droppedAttributesCount}`);
+    }
+    let line = parts.join("  ");
+    if (record.error)
+        line += `\n${formatError(record.error, paint)}`;
+    return line;
+}
+/** `HH:MM:ss.SSS`, local timezone. Millisecond resolution: the sub-millisecond
+ *  digits of the record's nanosecond timestamp are noise on a console line. */
+function formatLocalTime(timestamp) {
+    const date = new Date(Number(timestamp / 1000000n));
+    const hh = String(date.getHours()).padStart(2, "0");
+    const mm = String(date.getMinutes()).padStart(2, "0");
+    const ss = String(date.getSeconds()).padStart(2, "0");
+    const ms = String(date.getMilliseconds()).padStart(3, "0");
+    return `${hh}:${mm}:${ss}.${ms}`;
+}
+function formatAttributeValue(value) {
+    if (value === null)
+        return "null";
+    if (value instanceof Uint8Array)
+        return `<${value.byteLength} bytes>`;
+    if (typeof value === "object")
+        return quoteIfNeeded(JSON.stringify(value, jsonSafe));
+    return quoteIfNeeded(String(value));
+}
+/** Values containing whitespace, `"`, or `=` must be quoted so the `key=value`
+ *  stream stays unambiguously parseable by eye. */
+function quoteIfNeeded(text) {
+    return /[\s"=]/.test(text) ? JSON.stringify(text) : text;
+}
+function jsonSafe(_key, value) {
+    if (typeof value === "bigint")
+        return value.toString();
+    if (value instanceof Uint8Array)
+        return `<${value.byteLength} bytes>`;
+    return value;
+}
+/** Errors render after the message; the stack goes on following lines,
+ *  indented, unmodified. The `cause` chain follows, already bounded by §6.3. */
+function formatError(error, paint) {
+    const lines = [`  ${paint(LEVEL_COLOR[17], error.type)}: ${error.message}`];
+    if (error.stack) {
+        for (const line of error.stack.split("\n"))
+            lines.push(`    ${line}`);
+    }
+    let cause = error.cause;
+    let guard = 0;
+    while (cause && guard < 16) {
+        lines.push(`  ${paint(DIM, "caused by")} ${cause.type}: ${cause.message}`);
+        if (cause.stack) {
+            for (const line of cause.stack.split("\n"))
+                lines.push(`    ${line}`);
+        }
+        cause = cause.cause;
+        guard += 1;
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=encode-pretty.js.map

package/dist/logging/encode-pretty.js.map

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

package/dist/logging/file-sink.d.ts

@@ -0,0 +1,33 @@
+import type { LogRecord } from "@telorun/sdk";
+import { type BytesEncoder } from "./encode-json.js";
+import { type LogSinkInstance, type SinkBufferPolicy } from "./log-sink.js";
+/**
+ * `Telo.FileSink` — a kernel built-in (§10.2). Asynchronous, `json` by default.
+ *
+ * Sync-flushable: a positional write is available on every target platform, so a
+ * `fatal` record is durable by the time `log()` returns. That is what makes the
+ * file sink a legitimate audit destination while an OTLP sink is not — delivery
+ * there is a network round-trip that cannot complete without yielding.
+ */
+export type FileEncoding = "json" | "pretty";
+export interface FileSinkOptions {
+    sinkId: string;
+    level: number;
+    destination: string;
+    encoding?: FileEncoding;
+    policy?: SinkBufferPolicy;
+    onDrop: () => void;
+    encodeBytes?: BytesEncoder;
+}
+export declare class FileSink implements LogSinkInstance {
+    #private;
+    readonly sinkId: string;
+    readonly level: number;
+    readonly syncFlushable = true;
+    constructor(options: FileSinkOptions);
+    write(record: LogRecord): void;
+    flush(): Promise<void>;
+    flushSync(): void;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=file-sink.d.ts.map

package/dist/logging/file-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sink.d.ts","sourceRoot":"","sources":["../../src/logging/file-sink.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAyB,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGnG;;;;;;;GAOG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED,qBAAa,QAAS,YAAW,eAAe;;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,QAAQ;gBAQlB,OAAO,EAAE,eAAe;IAmBpC,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAKxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,SAAS,IAAI,IAAI;IASX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAU7B"}