@kelloggt/dsh-program-agents 0.0.0-stage → 0.1.0

package/dist/monitoring/error-buffer.js

@@ -0,0 +1,355 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { mkdir, open, rename, readFile, stat } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { errorFingerprint, isJson, isStandardLogRecord, MAX_LOG_LINE_BYTES, parseLogLine, redact } from './standard.js';
+import { LogSchemaRegistry } from './schemas.js';
+function number(value, fallback, minimum = 0) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isSafeInteger(value) || value < minimum)
+        throw new Error('Invalid error monitoring bound');
+    return value;
+}
+function isStandardPointer(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    return (!('path' in value) || typeof value.path === 'string') && (!('offset' in value) || Number.isSafeInteger(value.offset) && value.offset >= 0) && (!('run' in value) || typeof value.run === 'string' || !!value.run && typeof value.run.id === 'string' && Number.isSafeInteger(value.run.generation) && value.run.generation >= 0);
+}
+const baseOnlyRegistry = new LogSchemaRegistry();
+function sample(record) {
+    const clean = redact(record);
+    if (isJson(clean, 6) && Buffer.byteLength(JSON.stringify(clean)) <= 4096)
+        return clean;
+    // Retain identity and diagnostics, not large payloads, stacks or extensions.
+    const result = { timestamp: record.timestamp, level: 'ERROR', log_type: record.log_type, message: record.message.slice(0, 512) };
+    if (record.error)
+        result.error = { name: record.error.name.slice(0, 128), message: record.error.message.slice(0, 512), ...(record.error.code !== undefined ? { code: typeof record.error.code === 'string' ? record.error.code.slice(0, 128) : record.error.code } : {}) };
+    if (record.event_id)
+        result.event_id = record.event_id.slice(0, 128);
+    return result;
+}
+/** Durable, bounded, per-program at-least-once delivery. No parent routing policy here. */
+export class ErrorBuffer {
+    options;
+    ready;
+    outboxPath;
+    state;
+    queue;
+    timer;
+    closed = false;
+    closing = false;
+    lastFailure;
+    startupFailure;
+    queuedAdds = 0;
+    ingressDropped = 0;
+    delivery;
+    /** A deadline releases the waiter, never this real callback resource slot. */
+    activeHandler;
+    closeUntil = 0;
+    now;
+    constructor(options) {
+        this.options = options;
+        if (!options.key || options.key.length > 1024)
+            throw new Error('A bounded scoped ErrorBuffer key is required');
+        number(options.bufferMs, 1000);
+        number(options.cooldownMs, 30000);
+        number(options.retryMs, 1000, 1);
+        number(options.deliveryTimeoutMs, 10_000, 1);
+        number(options.maxBatch, 20, 1);
+        number(options.maxOutboxBytes, 1024 * 1024, MAX_LOG_LINE_BYTES * 2);
+        number(options.maxOutboxBatches, 64, 1);
+        number(options.maxPendingGroups, 200, 1);
+        this.now = options.clock ?? Date.now;
+        const name = createHash('sha256').update(options.key).digest('hex');
+        this.outboxPath = resolve(options.directory, `${name}.json`);
+        this.state = { version: 1, key: options.key, pending: [], outbox: [], seen: [], cooldown: [], dropped: 0 };
+        this.ready = this.load();
+        this.queue = this.ready.catch(error => { this.startupFailure = error; this.lastFailure = error; this.report(error); });
+    }
+    report(error) { try {
+        this.options.onError?.(error);
+    }
+    catch { /* reporting cannot break durability */ } }
+    async load() {
+        await mkdir(resolve(this.options.directory), { recursive: true, mode: 0o700 });
+        let text;
+        try {
+            const info = await stat(this.outboxPath);
+            if (info.size > number(this.options.maxOutboxBytes, 1024 * 1024) * 2)
+                throw new Error('Monitoring outbox exceeds configured bound');
+            text = await readFile(this.outboxPath, 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return;
+            throw error;
+        }
+        const decoded = JSON.parse(text);
+        if (!isJson(decoded) || !decoded || typeof decoded !== 'object' || Array.isArray(decoded))
+            throw new Error('Invalid monitoring outbox JSON');
+        const raw = decoded;
+        if (raw.version !== 1 || raw.key !== this.options.key || !Array.isArray(raw.pending) || !Array.isArray(raw.outbox) || !Array.isArray(raw.seen) || !Array.isArray(raw.cooldown) || !Number.isSafeInteger(raw.dropped) || raw.dropped < 0)
+            throw new Error('Invalid monitoring outbox');
+        if (raw.outbox.some(batch => !parseLogLine(JSON.stringify(batch)) || batch.log_type !== 'dsh.program.error-batch.v1') || raw.pending.some(group => !group || typeof group.fingerprint !== 'string' || !Number.isSafeInteger(group.count) || group.count < 1 || !Number.isFinite(group.due) || !group.range || typeof group.range.first !== 'string' || typeof group.range.last !== 'string' || !isStandardLogRecord(group.sample, baseOnlyRegistry)))
+            throw new Error('Invalid monitoring outbox payload');
+        if (raw.seen.some(x => !Array.isArray(x) || typeof x[0] !== 'string' || !Number.isFinite(x[1])) || raw.cooldown.some(x => !Array.isArray(x) || typeof x[0] !== 'string' || !Number.isFinite(x[1])))
+            throw new Error('Invalid monitoring deduplication state');
+        if (raw.pending.some(group => group.source && !isStandardPointer(group.source)))
+            throw new Error('Invalid monitoring source pointer');
+        this.state = raw;
+        this.trim();
+        if (this.options.enabled !== false && (raw.pending.length || raw.outbox.length))
+            this.schedule(0);
+    }
+    /** Fast enqueue. flush()/close() await persistence; failures remain observable. */
+    add(record, pointer) {
+        if (this.closed || this.closing || this.options.enabled === false || record.level !== 'ERROR' || record.log_type === 'dsh.program.error-batch.v1' || !isStandardLogRecord(record))
+            return false;
+        if (this.queuedAdds >= number(this.options.maxPendingGroups, 200, 1) * 2) {
+            this.ingressDropped++;
+            return false;
+        }
+        this.queuedAdds++;
+        const clean = sample(record);
+        const eventId = record.event_id?.slice(0, 1024);
+        const timestamp = record.timestamp;
+        const fingerprint = errorFingerprint(record);
+        const now = this.now();
+        const source = {};
+        if (pointer?.path)
+            source.path = pointer.path.slice(0, 4096);
+        if (pointer?.run)
+            source.run = typeof pointer.run === 'string' ? pointer.run.slice(0, 256) : { id: pointer.run.id.slice(0, 256), generation: pointer.run.generation };
+        if (pointer?.offset !== undefined && Number.isSafeInteger(pointer.offset) && pointer.offset >= 0)
+            source.offset = pointer.offset;
+        this.enqueue(async () => {
+            try {
+                if (this.startupFailure)
+                    throw this.startupFailure;
+                this.state.dropped += this.ingressDropped;
+                this.ingressDropped = 0;
+                this.state.seen = this.state.seen.filter(([, until]) => until > now);
+                if (eventId && this.state.seen.some(([id]) => id === eventId))
+                    return;
+                if (eventId)
+                    this.state.seen.push([eventId, now + 24 * 60 * 60 * 1000]);
+                this.state.seen = this.state.seen.slice(-4096);
+                const existing = this.state.pending.find(group => group.fingerprint === fingerprint);
+                if (existing) {
+                    existing.count++;
+                    existing.range.last = timestamp;
+                }
+                else {
+                    const cooldown = this.state.cooldown.find(([key]) => key === fingerprint)?.[1] ?? 0;
+                    this.state.pending.push({ fingerprint, count: 1, sample: clean, range: { first: timestamp, last: timestamp }, ...(Object.keys(source).length ? { source } : {}), due: Math.max(now + number(this.options.bufferMs, 1000), cooldown) });
+                }
+                this.trim();
+                await this.persist();
+                this.schedule();
+            }
+            finally {
+                this.queuedAdds--;
+            }
+        });
+        return true;
+    }
+    enqueue(work) {
+        this.queue = this.queue.then(work).catch(error => { this.lastFailure = error; this.report(error); if (!this.startupFailure)
+            this.schedule(number(this.options.retryMs, 1000, 1)); });
+        return this.queue;
+    }
+    trim() {
+        const maxGroups = number(this.options.maxPendingGroups, 200, 1);
+        while (this.state.pending.length > maxGroups)
+            this.state.dropped += this.state.pending.shift().count;
+        const maxBatches = number(this.options.maxOutboxBatches, 64, 1);
+        const maxBytes = number(this.options.maxOutboxBytes, 1024 * 1024);
+        while (this.state.outbox.length > maxBatches || Buffer.byteLength(JSON.stringify(this.state)) > maxBytes) {
+            if (this.state.outbox.length) {
+                const removed = this.state.outbox.shift();
+                this.state.dropped += removed.data.count + removed.data.dropped;
+            }
+            else if (this.state.pending.length)
+                this.state.dropped += this.state.pending.shift().count;
+            else if (this.state.seen.length)
+                this.state.seen.shift();
+            else if (this.state.cooldown.length)
+                this.state.cooldown.shift();
+            else
+                break;
+        }
+        this.state.cooldown = this.state.cooldown.filter(([, until]) => until > this.now()).slice(-4096);
+    }
+    async persist() {
+        this.trim();
+        const temp = `${this.outboxPath}.tmp-${process.pid}-${randomUUID()}`;
+        const file = await open(temp, 'wx', 0o600);
+        try {
+            await file.writeFile(JSON.stringify(this.state), 'utf8');
+            await file.sync();
+        }
+        finally {
+            await file.close();
+        }
+        // Resolved target is the constructor's scoped, hashed outbox path.
+        await rename(temp, this.outboxPath);
+    }
+    schedule(delay) {
+        if (this.closed || this.closing || this.options.enabled === false)
+            return;
+        if (this.timer)
+            clearTimeout(this.timer);
+        if (delay === undefined) {
+            const due = Math.min(...this.state.pending.map(group => group.due));
+            delay = this.state.outbox.length ? number(this.options.retryMs, 1000, 1) : Math.max(0, due - this.now());
+            if (!Number.isFinite(delay))
+                return;
+        }
+        this.timer = setTimeout(() => { this.timer = undefined; void this.enqueue(() => this.drain(false)); }, Math.min(delay, 2147483647));
+        this.timer.unref();
+    }
+    makeBatch(groups) {
+        const first = groups.map(g => g.range.first).sort()[0];
+        const last = groups.map(g => g.range.last).sort().at(-1);
+        return {
+            timestamp: new Date(this.now()).toISOString(), level: 'ERROR', log_type: 'dsh.program.error-batch.v1',
+            message: `${groups.reduce((sum, g) => sum + g.count, 0)} program error(s) in ${groups.length} group(s)`, event_id: randomUUID(),
+            data: { key: this.options.key, groups: groups.map(({ due: _, ...group }) => group), count: groups.reduce((sum, g) => sum + g.count, 0), range: { first, last }, dropped: this.state.dropped },
+        };
+    }
+    async deliver(batch) {
+        if (this.activeHandler)
+            throw new Error('Monitoring delivery callback is still active');
+        const controller = new AbortController();
+        this.delivery = controller;
+        const handler = Promise.resolve().then(() => this.options.deliver(batch, controller.signal));
+        this.activeHandler = handler;
+        const release = () => {
+            if (this.activeHandler === handler)
+                this.activeHandler = undefined;
+            if (this.delivery === controller)
+                this.delivery = undefined;
+        };
+        // Both settlement paths release the slot, without creating an unhandled rejection.
+        void handler.then(release, release);
+        let timeout;
+        let abort;
+        try {
+            const interrupted = new Promise((_, reject) => {
+                abort = () => reject(controller.signal.reason ?? new Error('Monitoring delivery aborted'));
+                controller.signal.addEventListener('abort', abort, { once: true });
+                timeout = setTimeout(() => controller.abort(new Error('Monitoring delivery deadline exceeded')), this.closing ? Math.max(1, this.closeUntil - Date.now()) : number(this.options.deliveryTimeoutMs, 10_000, 1));
+            });
+            await Promise.race([handler, interrupted]);
+        }
+        finally {
+            if (timeout)
+                clearTimeout(timeout);
+            if (abort)
+                controller.signal.removeEventListener('abort', abort);
+            // Keep activeHandler/delivery until the actual callback settles, even if aborted.
+        }
+    }
+    async drain(force) {
+        if (this.startupFailure)
+            throw this.startupFailure;
+        if (this.options.enabled === false)
+            return;
+        this.state.dropped += this.ingressDropped;
+        this.ingressDropped = 0;
+        const now = this.now();
+        let eligible = this.state.pending.filter(group => force || group.due <= now);
+        while (eligible.length) {
+            const groups = [];
+            for (const group of eligible.slice(0, Math.min(20, number(this.options.maxBatch, 20, 1)))) {
+                const candidate = this.makeBatch([...groups, group]);
+                if (Buffer.byteLength(JSON.stringify(candidate)) > MAX_LOG_LINE_BYTES - 1)
+                    break;
+                groups.push(group);
+            }
+            if (!groups.length) {
+                const discarded = eligible[0];
+                this.state.dropped += discarded.count;
+                this.state.pending = this.state.pending.filter(g => g !== discarded);
+            }
+            else {
+                const batch = this.makeBatch(groups);
+                this.state.dropped = 0;
+                this.state.pending = this.state.pending.filter(g => !groups.includes(g));
+                for (const group of groups) {
+                    this.state.cooldown = this.state.cooldown.filter(([key]) => key !== group.fingerprint);
+                    this.state.cooldown.push([group.fingerprint, now + number(this.options.cooldownMs, 30000)]);
+                }
+                this.state.outbox.push(batch);
+            }
+            eligible = this.state.pending.filter(group => force || group.due <= now);
+        }
+        // Persist before attempting delivery. An interrupted receipt can replay an event_id.
+        await this.persist();
+        if (force && this.closing)
+            this.closeUntil = Date.now() + 100;
+        while (this.state.outbox.length && (!this.closing || Date.now() < this.closeUntil)) {
+            const batch = this.state.outbox[0];
+            try {
+                await this.deliver(batch);
+            }
+            catch (error) {
+                this.report(error);
+                break;
+            }
+            this.state.outbox.shift();
+            await this.persist();
+        }
+        this.schedule();
+    }
+    /** Await queued ingestion becoming durable without forcing delivery/cooldown. */
+    async checkpoint() {
+        await this.queue;
+        if (this.lastFailure) {
+            const error = this.lastFailure;
+            this.lastFailure = undefined;
+            throw error;
+        }
+    }
+    /** Force the normal buffer window, but preserve per-fingerprint cooldown. */
+    async flush() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+        await this.enqueue(async () => {
+            const now = this.now();
+            for (const group of this.state.pending) {
+                const cooldown = this.state.cooldown.find(([key]) => key === group.fingerprint)?.[1] ?? 0;
+                if (cooldown <= now)
+                    group.due = now;
+            }
+            await this.drain(false);
+        });
+        if (this.lastFailure) {
+            const error = this.lastFailure;
+            this.lastFailure = undefined;
+            throw error;
+        }
+    }
+    /** Final errors bypass cooldown; rejected deliveries stay on disk for restart. */
+    async close() {
+        if (this.closed)
+            return;
+        this.closing = true;
+        this.closeUntil = Date.now() + 100;
+        this.delivery?.abort(new Error('Monitoring is closing; delivery retained for restart'));
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+        await this.enqueue(() => this.drain(true));
+        this.closed = true;
+        if (this.lastFailure) {
+            const error = this.lastFailure;
+            this.lastFailure = undefined;
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=error-buffer.js.map

package/dist/monitoring/error-buffer.js.map

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

package/dist/monitoring/fatal.d.ts

@@ -0,0 +1,6 @@
+import type { StructuredLogger } from './logger.js';
+/** Report once, flush within a hard deadline, then exit nonzero. Never keep a
+ * process alive after an uncaught exception/unhandled rejection. Opt-in only. */
+export declare function installGlobalErrorHandlers(logger: StructuredLogger, options?: {
+    timeoutMs?: number;
+}): () => void;

package/dist/monitoring/fatal.js

@@ -0,0 +1,32 @@
+/** Report once, flush within a hard deadline, then exit nonzero. Never keep a
+ * process alive after an uncaught exception/unhandled rejection. Opt-in only. */
+export function installGlobalErrorHandlers(logger, options = {}) {
+    const timeout = options.timeoutMs ?? 500;
+    if (!Number.isSafeInteger(timeout) || timeout < 1 || timeout > 5000)
+        throw Error('Invalid fatal log timeout');
+    let failing = false;
+    const fail = (reason, kind) => {
+        if (failing) {
+            process.exit(1);
+            return;
+        }
+        failing = true;
+        // Referenced deadline guarantees an exit even if stdout/disk backpressure hangs.
+        const timer = setTimeout(() => process.exit(1), timeout);
+        try {
+            const error = reason instanceof Error ? reason : new Error(typeof reason === 'string' ? reason : 'Non-Error thrown/rejected value');
+            logger.error('Unhandled program error', { unhandled: true, kind }, { log_type: 'dsh.program.error.v1', error, fatal: true });
+        }
+        catch {
+            clearTimeout(timer);
+            process.exit(1);
+            return;
+        }
+        void logger.flush().catch(() => { }).finally(() => { clearTimeout(timer); process.exit(1); });
+    };
+    const exception = (error) => fail(error, 'uncaughtException'), rejection = (reason) => fail(reason, 'unhandledRejection');
+    process.on('uncaughtException', exception);
+    process.on('unhandledRejection', rejection);
+    return () => { process.off('uncaughtException', exception); process.off('unhandledRejection', rejection); };
+}
+//# sourceMappingURL=fatal.js.map

package/dist/monitoring/fatal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fatal.js","sourceRoot":"","sources":["../../src/monitoring/fatal.ts"],"names":[],"mappings":"AACA;iFACiF;AACjF,MAAM,UAAU,0BAA0B,CAAC,MAAuB,EAAC,UAA4B,EAAE;IAChG,MAAM,OAAO,GAAC,OAAO,CAAC,SAAS,IAAE,GAAG,CAAC;IAAA,IAAG,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAE,OAAO,GAAC,CAAC,IAAE,OAAO,GAAC,IAAI;QAAC,MAAM,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACzI,IAAI,OAAO,GAAC,KAAK,CAAC;IAClB,MAAM,IAAI,GAAC,CAAC,MAAc,EAAC,IAA6C,EAAC,EAAE;QAC1E,IAAG,OAAO,EAAC,CAAC;YAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAAA,OAAO;QAAA,CAAC;QAAA,OAAO,GAAC,IAAI,CAAC;QACjD,iFAAiF;QACjF,MAAM,KAAK,GAAC,UAAU,CAAC,GAAE,EAAE,CAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAC,OAAO,CAAC,CAAC;QACpD,IAAG,CAAC;YAAA,MAAM,KAAK,GAAC,MAAM,YAAY,KAAK,CAAA,CAAC,CAAA,MAAM,CAAA,CAAC,CAAA,IAAI,KAAK,CAAC,OAAO,MAAM,KAAG,QAAQ,CAAA,CAAC,CAAA,MAAM,CAAA,CAAC,CAAA,iCAAiC,CAAC,CAAC;YAAA,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAC,EAAC,SAAS,EAAC,IAAI,EAAC,IAAI,EAAC,EAAC,EAAC,QAAQ,EAAC,sBAAsB,EAAC,KAAK,EAAC,KAAK,EAAC,IAAI,EAAC,CAAC,CAAC;QAAA,CAAC;QAC9O,MAAK,CAAC;YAAA,YAAY,CAAC,KAAK,CAAC,CAAC;YAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAAA,OAAO;QAAA,CAAC;QAClD,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAE,EAAE,GAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAE,EAAE,GAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC;IACvF,CAAC,CAAC;IACF,MAAM,SAAS,GAAC,CAAC,KAAW,EAAC,EAAE,CAAA,IAAI,CAAC,KAAK,EAAC,mBAAmB,CAAC,EAAC,SAAS,GAAC,CAAC,MAAc,EAAC,EAAE,CAAA,IAAI,CAAC,MAAM,EAAC,oBAAoB,CAAC,CAAC;IAC7H,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAC,SAAS,CAAC,CAAC;IAAA,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAC,SAAS,CAAC,CAAC;IACrF,OAAM,GAAE,EAAE,GAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAC,SAAS,CAAC,CAAC,CAAA,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAC,SAAS,CAAC,CAAC,CAAA,CAAC,CAAC;AACrG,CAAC"}

package/dist/monitoring/index.d.ts

@@ -0,0 +1,7 @@
+/** Versioned JSONL logging and parent-owned monitoring primitives. */
+export * from './standard.js';
+export * from './schemas.js';
+export * from './logger.js';
+export * from './fatal.js';
+export * from './error-buffer.js';
+export * from './tailer.js';

package/dist/monitoring/index.js

@@ -0,0 +1,8 @@
+/** Versioned JSONL logging and parent-owned monitoring primitives. */
+export * from './standard.js';
+export * from './schemas.js';
+export * from './logger.js';
+export * from './fatal.js';
+export * from './error-buffer.js';
+export * from './tailer.js';
+//# sourceMappingURL=index.js.map

package/dist/monitoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/monitoring/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}

package/dist/monitoring/logger.d.ts

@@ -0,0 +1,45 @@
+import type { Writable } from 'node:stream';
+import { type JsonValue, type StandardLogError, type StandardLogRecord } from './standard.js';
+import { type LogSchemaRegistry } from './schemas.js';
+export interface LoggerOptions {
+    stdout?: boolean | Writable;
+    /** Opt-in file output; logsPath is a directory containing app-log.jsonl. */
+    file?: string;
+    logsPath?: string;
+    maxBytes?: number;
+    /** Total file count, including the active file. Defaults to 5. */
+    maxFiles?: number;
+    private?: boolean;
+    maxQueueBytes?: number;
+    clock?: () => Date;
+    registry?: LogSchemaRegistry;
+}
+export interface LogMetadata {
+    log_type?: string;
+    timestamp?: string;
+    operation_id?: string;
+    event_id?: string;
+    error?: StandardLogError | Error;
+    fatal?: boolean;
+    [extension: string]: unknown;
+}
+/** Serialized writes respect stdout backpressure, with a bounded application queue. */
+export declare class StructuredLogger {
+    private readonly options;
+    private queue;
+    private pendingBytes;
+    private failure;
+    private closed;
+    private readonly file?;
+    private readonly stdout?;
+    constructor(options?: LoggerOptions);
+    debug(message: string, data?: JsonValue, metadata?: LogMetadata): StandardLogRecord;
+    info(message: string, data?: JsonValue, metadata?: LogMetadata): StandardLogRecord;
+    warn(message: string, data?: JsonValue, metadata?: LogMetadata): StandardLogRecord;
+    error(message: string, data?: JsonValue, metadata?: LogMetadata): StandardLogRecord;
+    private log;
+    record(input: StandardLogRecord): StandardLogRecord;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+export declare function createLogger(options?: LoggerOptions): StructuredLogger;