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

package/dist/monitoring/logger.js

@@ -0,0 +1,174 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, open, rename, stat, chmod } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { errorFingerprint, isJson, isStandardLogRecord, MAX_LOG_LINE_BYTES, redact } from './standard.js';
+import { defaultLogRegistry } from './schemas.js';
+function positive(value, fallback, name) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new Error(`Invalid ${name}`);
+    return value;
+}
+function normalizeError(error) {
+    if (!(error instanceof Error))
+        return error;
+    const result = { name: error.name, message: error.message };
+    if (error.stack)
+        result.stack = error.stack;
+    const code = error.code;
+    if (typeof code === 'string' || typeof code === 'number')
+        result.code = code;
+    return result;
+}
+class RotatingFile {
+    options;
+    bytes = 0;
+    day = '';
+    initialized = false;
+    path;
+    constructor(file, options) {
+        this.options = options;
+        this.path = resolve(file);
+    }
+    async write(line, now) {
+        if (!this.initialized) {
+            await mkdir(dirname(this.path), { recursive: true, ...(this.options.private ? { mode: 0o700 } : {}) });
+            try {
+                const s = await stat(this.path);
+                this.bytes = s.size;
+                this.day = s.mtime.toISOString().slice(0, 10);
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+            this.initialized = true;
+        }
+        const today = now.toISOString().slice(0, 10);
+        const length = Buffer.byteLength(line);
+        if (this.bytes && (this.bytes + length > positive(this.options.maxBytes, 10 * 1024 * 1024, 'maxBytes') || this.day !== today)) {
+            const count = positive(this.options.maxFiles, 5, 'maxFiles');
+            if (count === 1) {
+                const f = await open(this.path, 'w', this.options.private ? 0o600 : 0o666);
+                await f.close();
+            }
+            else {
+                // Every target is the resolved configured path plus a fixed numeric suffix.
+                for (let i = count - 2; i >= 0; i--) {
+                    const from = i === 0 ? this.path : `${this.path}.${i}`;
+                    const to = `${this.path}.${i + 1}`;
+                    try {
+                        await rename(from, to);
+                    }
+                    catch (error) {
+                        if (error.code !== 'ENOENT')
+                            throw error;
+                    }
+                }
+            }
+            this.bytes = 0;
+        }
+        const handle = await open(this.path, 'a', this.options.private ? 0o600 : 0o666);
+        try {
+            if (this.options.private)
+                await chmod(this.path, 0o600);
+            await handle.writeFile(line, 'utf8');
+        }
+        finally {
+            await handle.close();
+        }
+        this.bytes += length;
+        this.day = today;
+    }
+}
+/** Serialized writes respect stdout backpressure, with a bounded application queue. */
+export class StructuredLogger {
+    options;
+    queue = Promise.resolve();
+    pendingBytes = 0;
+    failure;
+    closed = false;
+    file;
+    stdout;
+    constructor(options = {}) {
+        this.options = options;
+        positive(options.maxBytes, 10 * 1024 * 1024, 'maxBytes');
+        positive(options.maxFiles, 5, 'maxFiles');
+        positive(options.maxQueueBytes, 1024 * 1024, 'maxQueueBytes');
+        if (options.file && options.logsPath)
+            throw new Error('Use file or logsPath, not both');
+        const file = options.file ?? (options.logsPath ? resolve(options.logsPath, 'app-log.jsonl') : undefined);
+        if (file)
+            this.file = new RotatingFile(file, options);
+        this.stdout = options.stdout === false ? undefined : options.stdout && typeof options.stdout !== 'boolean' ? options.stdout : process.stdout;
+    }
+    debug(message, data, metadata) { return this.log('DEBUG', message, data, metadata); }
+    info(message, data, metadata) { return this.log('INFO', message, data, metadata); }
+    warn(message, data, metadata) { return this.log('WARNING', message, data, metadata); }
+    error(message, data, metadata) { return this.log('ERROR', message, data, metadata); }
+    log(level, message, data, metadata = {}) {
+        const record = { ...metadata, timestamp: metadata.timestamp ?? (this.options.clock?.() ?? new Date()).toISOString(), level, log_type: metadata.log_type ?? (level === 'ERROR' ? 'dsh.program.error.v1' : 'dsh.program.log.v1'), message };
+        if (data !== undefined)
+            record.data = data;
+        if (metadata.error)
+            record.error = normalizeError(metadata.error);
+        return this.record(record);
+    }
+    record(input) {
+        if (this.closed)
+            throw new Error('Logger is closed');
+        if (!isJson(input))
+            throw new Error('Log record must contain finite, bounded JSON values');
+        const record = redact(input);
+        record.event_id ??= randomUUID();
+        if (record.level === 'ERROR') {
+            record.error ??= { name: 'Error', message: record.message };
+            record.error.fingerprint = errorFingerprint(record);
+        }
+        if (!isStandardLogRecord(record, this.options.registry ?? defaultLogRegistry))
+            throw new Error('Invalid standard log record or registered payload');
+        const line = JSON.stringify(record) + '\n';
+        const size = Buffer.byteLength(line);
+        if (size > MAX_LOG_LINE_BYTES)
+            throw new Error('Log line exceeds 64 KiB');
+        if (this.pendingBytes + size > positive(this.options.maxQueueBytes, 1024 * 1024, 'maxQueueBytes'))
+            throw new Error('Log queue capacity exceeded; await flush()');
+        this.pendingBytes += size;
+        this.queue = this.queue.then(async () => {
+            try {
+                // File first: a blocked stdout must not prevent this record becoming durable.
+                if (this.file)
+                    await this.file.write(line, this.options.clock?.() ?? new Date());
+                if (this.stdout)
+                    await new Promise((yes, no) => {
+                        const stream = this.stdout;
+                        const onError = (error) => { stream.off('error', onError); no(error); };
+                        stream.once('error', onError);
+                        try {
+                            stream.write(line, error => { stream.off('error', onError); error ? no(error) : yes(); });
+                        }
+                        catch (error) {
+                            stream.off('error', onError);
+                            no(error);
+                        }
+                    });
+            }
+            catch (error) {
+                this.failure ??= error;
+            }
+            finally {
+                this.pendingBytes -= size;
+            }
+        });
+        return record;
+    }
+    async flush() { await this.queue; if (this.failure) {
+        const error = this.failure;
+        this.failure = undefined;
+        throw error;
+    } }
+    async close() { this.closed = true; await this.flush(); }
+}
+export function createLogger(options = {}) { return new StructuredLogger(options); }
+//# sourceMappingURL=logger.js.map

package/dist/monitoring/logger.js.map

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

package/dist/monitoring/schemas.d.ts

@@ -0,0 +1,34 @@
+import type { JsonValue } from '../types.js';
+/** Deliberately small JSON Schema subset; unsupported keywords fail registration. */
+export interface PayloadSchema {
+    type?: 'object' | 'array' | 'string' | 'number' | 'integer' | 'boolean' | 'null';
+    properties?: Record<string, PayloadSchema>;
+    required?: string[];
+    additionalProperties?: boolean | PayloadSchema;
+    items?: PayloadSchema;
+    enum?: JsonValue[];
+    const?: JsonValue;
+    oneOf?: PayloadSchema[];
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+    minItems?: number;
+    maxItems?: number;
+    pattern?: string;
+    description?: string;
+    $id?: string;
+    $schema?: string;
+    title?: string;
+}
+export declare class LogSchemaRegistry {
+    private readonly schemas;
+    register(logType: string, schema: PayloadSchema, options?: {
+        optional?: boolean;
+    }): this;
+    validate(logType: string, data: unknown): boolean;
+    get(logType: string): PayloadSchema | undefined;
+}
+export declare const errorBatchPayloadSchema: PayloadSchema;
+export declare const httpRequestPayloadSchema: PayloadSchema;
+export declare const defaultLogRegistry: LogSchemaRegistry;

package/dist/monitoring/schemas.js

@@ -0,0 +1,132 @@
+const keywords = new Set(['type', 'properties', 'required', 'additionalProperties', 'items', 'enum', 'const', 'oneOf', 'minLength', 'maxLength', 'minimum', 'maximum', 'minItems', 'maxItems', 'pattern', 'description', '$id', '$schema', 'title']);
+function canonical(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(',')}]`;
+    if (value && typeof value === 'object')
+        return `{${Object.entries(value).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => `${JSON.stringify(k)}:${canonical(v)}`).join(',')}}`;
+    return JSON.stringify(value);
+}
+function checkSchema(schema, depth = 0) {
+    if (depth > 32 || !schema || typeof schema !== 'object' || Array.isArray(schema) || ![Object.prototype, null].includes(Object.getPrototypeOf(schema)))
+        throw new Error('Invalid payload schema');
+    for (const key of Object.keys(schema))
+        if (!keywords.has(key))
+            throw new Error(`Unsupported schema keyword: ${key}`);
+    if (schema.type !== undefined && !['object', 'array', 'string', 'number', 'integer', 'boolean', 'null'].includes(schema.type))
+        throw new Error('Invalid schema type');
+    for (const key of ['minLength', 'maxLength', 'minItems', 'maxItems'])
+        if (schema[key] !== undefined && (!Number.isSafeInteger(schema[key]) || schema[key] < 0))
+            throw new Error(`Invalid schema ${key}`);
+    for (const key of ['minimum', 'maximum'])
+        if (schema[key] !== undefined && !Number.isFinite(schema[key]))
+            throw new Error(`Invalid schema ${key}`);
+    for (const key of ['description', 'pattern', '$id', '$schema', 'title'])
+        if (schema[key] !== undefined && typeof schema[key] !== 'string')
+            throw new Error(`Invalid schema ${key}`);
+    if (schema.required !== undefined && (!Array.isArray(schema.required) || !schema.required.every(x => typeof x === 'string')))
+        throw new Error('Invalid schema required');
+    if (schema.enum !== undefined && !Array.isArray(schema.enum))
+        throw new Error('Invalid schema enum');
+    const lossless = (value, level = 0) => level <= 32 && (value === null || typeof value === 'string' || typeof value === 'boolean' || typeof value === 'number' && Number.isFinite(value) || !!value && typeof value === 'object' && (Array.isArray(value) ? value.every(x => lossless(x, level + 1)) : [Object.prototype, null].includes(Object.getPrototypeOf(value)) && Object.values(value).every(x => lossless(x, level + 1))));
+    if (schema.enum && !lossless(schema.enum) || 'const' in schema && !lossless(schema.const))
+        throw new Error('Schema values must be bounded finite JSON');
+    if (schema.pattern)
+        new RegExp(schema.pattern);
+    if (schema.properties !== undefined && (!schema.properties || typeof schema.properties !== 'object' || Array.isArray(schema.properties)))
+        throw new Error('Invalid schema properties');
+    for (const child of Object.values(schema.properties ?? {}))
+        checkSchema(child, depth + 1);
+    if (schema.items !== undefined)
+        checkSchema(schema.items, depth + 1);
+    if (schema.additionalProperties !== undefined && typeof schema.additionalProperties !== 'boolean')
+        checkSchema(schema.additionalProperties, depth + 1);
+    if (schema.oneOf !== undefined && (!Array.isArray(schema.oneOf) || !schema.oneOf.length))
+        throw new Error('Invalid schema oneOf');
+    for (const child of schema.oneOf ?? [])
+        checkSchema(child, depth + 1);
+}
+function matches(value, schema) {
+    if (schema.oneOf && schema.oneOf.filter(s => matches(value, s)).length !== 1)
+        return false;
+    if ('const' in schema && canonical(value) !== canonical(schema.const))
+        return false;
+    if (schema.enum && !schema.enum.some(x => canonical(value) === canonical(x)))
+        return false;
+    if (schema.type) {
+        const valid = schema.type === 'null' ? value === null : schema.type === 'array' ? Array.isArray(value)
+            : schema.type === 'object' ? !!value && typeof value === 'object' && !Array.isArray(value)
+                : schema.type === 'integer' ? typeof value === 'number' && Number.isInteger(value)
+                    : typeof value === schema.type;
+        if (!valid)
+            return false;
+    }
+    if (typeof value === 'string') {
+        if (schema.minLength !== undefined && value.length < schema.minLength || schema.maxLength !== undefined && value.length > schema.maxLength)
+            return false;
+        if (schema.pattern && !new RegExp(schema.pattern).test(value))
+            return false;
+    }
+    if (typeof value === 'number' && (!Number.isFinite(value) || schema.minimum !== undefined && value < schema.minimum || schema.maximum !== undefined && value > schema.maximum))
+        return false;
+    if (Array.isArray(value)) {
+        if (schema.minItems !== undefined && value.length < schema.minItems || schema.maxItems !== undefined && value.length > schema.maxItems)
+            return false;
+        if (schema.items && !value.every(x => matches(x, schema.items)))
+            return false;
+    }
+    else if (value && typeof value === 'object') {
+        const record = value;
+        if (schema.required?.some(key => !(key in record)))
+            return false;
+        for (const [key, child] of Object.entries(record)) {
+            const property = schema.properties && Object.hasOwn(schema.properties, key) ? schema.properties[key] : undefined;
+            if (property ? !matches(child, property) : schema.additionalProperties === false || typeof schema.additionalProperties === 'object' && !matches(child, schema.additionalProperties))
+                return false;
+        }
+    }
+    return true;
+}
+export class LogSchemaRegistry {
+    schemas = new Map();
+    register(logType, schema, options = {}) {
+        if (!/^[a-z][a-z0-9_-]*(?:\.[a-z][a-z0-9_-]*)+\.v[1-9][0-9]*$/.test(logType) || logType.length > 256)
+            throw new Error('Expected a versioned namespaced log_type');
+        checkSchema(schema);
+        const signature = canonical({ schema, optional: !!options.optional });
+        const prior = this.schemas.get(logType);
+        if (prior && prior.signature !== signature)
+            throw new Error(`Schema ${logType} is immutable; publish a new version`);
+        this.schemas.set(logType, { schema: JSON.parse(JSON.stringify(schema)), signature, optional: !!options.optional });
+        return this;
+    }
+    validate(logType, data) {
+        const registered = this.schemas.get(logType);
+        return !registered || data === undefined && registered.optional || matches(data, registered.schema);
+    }
+    get(logType) {
+        const schema = this.schemas.get(logType)?.schema;
+        return schema && JSON.parse(JSON.stringify(schema));
+    }
+}
+const sourceSchema = { type: 'object', properties: { path: { type: 'string' }, offset: { type: 'integer', minimum: 0 }, run: { oneOf: [{ type: 'string' }, { type: 'object', required: ['id', 'generation'], properties: { id: { type: 'string' }, generation: { type: 'integer', minimum: 0 } }, additionalProperties: false }] } }, additionalProperties: false };
+export const errorBatchPayloadSchema = {
+    type: 'object', required: ['key', 'groups', 'count', 'range', 'dropped'], additionalProperties: true,
+    properties: {
+        key: { type: 'string' }, count: { type: 'integer', minimum: 1 }, dropped: { type: 'integer', minimum: 0 },
+        range: { type: 'object', required: ['first', 'last'], properties: { first: { type: 'string' }, last: { type: 'string' } }, additionalProperties: false },
+        groups: { type: 'array', minItems: 1, maxItems: 20, items: { type: 'object', required: ['fingerprint', 'count', 'sample', 'range'], additionalProperties: true, properties: {
+                    fingerprint: { type: 'string' }, count: { type: 'integer', minimum: 1 }, sample: { type: 'object' },
+                    range: { type: 'object', required: ['first', 'last'], properties: { first: { type: 'string' }, last: { type: 'string' } }, additionalProperties: false },
+                    source: sourceSchema,
+                } } },
+    },
+};
+export const httpRequestPayloadSchema = {
+    type: 'object', required: ['method', 'path', 'status'], additionalProperties: true,
+    properties: { method: { type: 'string', minLength: 1, maxLength: 32 }, path: { type: 'string' }, status: { type: 'integer', minimum: 100, maximum: 599 }, duration_ms: { type: 'number', minimum: 0 } },
+};
+export const defaultLogRegistry = new LogSchemaRegistry()
+    .register('dsh.program.error.v1', { type: 'object', additionalProperties: true }, { optional: true })
+    .register('dsh.http.request.v1', httpRequestPayloadSchema)
+    .register('dsh.program.error-batch.v1', errorBatchPayloadSchema);
+//# sourceMappingURL=schemas.js.map

package/dist/monitoring/schemas.js.map

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

package/dist/monitoring/standard.d.ts

@@ -0,0 +1,51 @@
+import type { JsonValue } from '../types.js';
+import { LogSchemaRegistry } from './schemas.js';
+export type { JsonValue };
+export declare const MAX_LOG_LINE_BYTES: number;
+export declare const MAX_LOG_DEPTH = 32;
+export declare const LOG_LEVELS: readonly ["DEBUG", "INFO", "WARNING", "ERROR"];
+export type LogLevel = typeof LOG_LEVELS[number];
+export interface StandardLogError {
+    name: string;
+    message: string;
+    stack?: string;
+    code?: string | number;
+    fingerprint?: string;
+}
+/** Extensions are allowed, but must be bounded, finite JSON values. */
+export interface StandardLogRecord {
+    timestamp: string;
+    level: LogLevel;
+    log_type: string;
+    message: string;
+    operation_id?: string;
+    event_id?: string;
+    error?: StandardLogError;
+    data?: JsonValue;
+    /** Advisory only: ERROR severity, not this flag, drives error monitoring. */
+    fatal?: boolean;
+    [extension: string]: unknown;
+}
+export declare const LOG_TYPE_PATTERN: RegExp;
+export declare function isLogType(value: unknown): value is string;
+/** Validate before serializing: JSON.stringify silently loses undefined/NaN/class values. */
+export declare function isJson(value: unknown, depth?: number, seen?: Set<object>): value is JsonValue;
+export declare function isStandardLogRecord(value: unknown, registry?: LogSchemaRegistry): value is StandardLogRecord;
+/** Invalid/nonstandard/oversize lines are ignored, never interpreted as instructions. */
+export declare function parseLogLine(line: string, registry?: LogSchemaRegistry): StandardLogRecord | undefined;
+/** Stable across timestamps, stack positions, sources and stdout/file duplicates. */
+export declare function errorFingerprint(record: StandardLogRecord): string;
+/** Header objects are deliberately wholly redacted, rather than guessing safe headers. */
+export declare function redact(value: JsonValue): JsonValue;
+/** Useful to host stdout parsers too: bounded fragments, including oversize lines. */
+export declare class JsonlDecoder {
+    private readonly onRecord;
+    private readonly registry;
+    private pending;
+    private skipping;
+    constructor(onRecord: (record: StandardLogRecord, endOffset: number) => void, registry?: LogSchemaRegistry);
+    push(chunk: Buffer | string, startOffset?: number): void;
+    reset(): void;
+    discardPartialLine(): void;
+    get pendingBytes(): number;
+}

package/dist/monitoring/standard.js

@@ -0,0 +1,140 @@
+import { createHash } from 'node:crypto';
+import { defaultLogRegistry } from './schemas.js';
+export const MAX_LOG_LINE_BYTES = 64 * 1024;
+export const MAX_LOG_DEPTH = 32;
+export const LOG_LEVELS = ['DEBUG', 'INFO', 'WARNING', 'ERROR'];
+export const LOG_TYPE_PATTERN = /^[a-z][a-z0-9_-]*(?:\.[a-z][a-z0-9_-]*)+\.v[1-9][0-9]*$/;
+export function isLogType(value) {
+    return typeof value === 'string' && value.length <= 256 && LOG_TYPE_PATTERN.test(value);
+}
+/** Validate before serializing: JSON.stringify silently loses undefined/NaN/class values. */
+export function isJson(value, depth = 0, seen = new Set()) {
+    if (depth > MAX_LOG_DEPTH)
+        return false;
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return true;
+    if (typeof value === 'number')
+        return Number.isFinite(value);
+    if (typeof value !== 'object' || seen.has(value))
+        return false;
+    if (!Array.isArray(value) && Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)
+        return false;
+    seen.add(value);
+    const valid = Array.isArray(value)
+        ? Array.from({ length: value.length }, (_, i) => i in value && isJson(value[i], depth + 1, seen)).every(Boolean)
+        : Object.values(value).every(child => isJson(child, depth + 1, seen));
+    seen.delete(value);
+    return valid;
+}
+function object(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function optionalString(o, key) {
+    return !(key in o) || typeof o[key] === 'string';
+}
+function validTimestamp(value) {
+    const match = /^(\d{4})-(\d\d)-(\d\d)T(\d\d):(\d\d):(\d\d)(?:\.\d{1,9})?(?:Z|([+-])(\d\d):(\d\d))$/.exec(value);
+    if (!match || !Number.isFinite(Date.parse(value)))
+        return false;
+    const [, year, month, day, hour, minute, second, , zoneHour, zoneMinute] = match;
+    const y = Number(year), m = Number(month), d = Number(day);
+    const leap = y % 4 === 0 && (y % 100 !== 0 || y % 400 === 0);
+    const days = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+    return m >= 1 && m <= 12 && d >= 1 && d <= days[m - 1] && Number(hour) < 24 && Number(minute) < 60 && Number(second) < 60 && (!zoneHour || Number(zoneHour) < 24 && Number(zoneMinute) < 60);
+}
+export function isStandardLogRecord(value, registry = defaultLogRegistry) {
+    if (!isJson(value) || !object(value))
+        return false;
+    if (typeof value.timestamp !== 'string' || !validTimestamp(value.timestamp))
+        return false;
+    if (!LOG_LEVELS.includes(value.level) || !isLogType(value.log_type) || typeof value.message !== 'string')
+        return false;
+    if (!optionalString(value, 'operation_id') || !optionalString(value, 'event_id'))
+        return false;
+    if ('fatal' in value && typeof value.fatal !== 'boolean')
+        return false;
+    if ('error' in value) {
+        const e = value.error;
+        if (!object(e) || typeof e.name !== 'string' || typeof e.message !== 'string' || !optionalString(e, 'stack') || !optionalString(e, 'fingerprint'))
+            return false;
+        if ('code' in e && typeof e.code !== 'string' && typeof e.code !== 'number')
+            return false;
+    }
+    return registry.validate(value.log_type, value.data);
+}
+/** Invalid/nonstandard/oversize lines are ignored, never interpreted as instructions. */
+export function parseLogLine(line, registry = defaultLogRegistry) {
+    if (typeof line !== 'string' || Buffer.byteLength(line, 'utf8') > MAX_LOG_LINE_BYTES)
+        return undefined;
+    try {
+        const value = JSON.parse(line);
+        return isStandardLogRecord(value, registry) ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Stable across timestamps, stack positions, sources and stdout/file duplicates. */
+export function errorFingerprint(record) {
+    return createHash('sha256').update(JSON.stringify([
+        record.log_type, record.message, record.error?.name ?? null,
+        record.error?.message ?? null, record.error?.code ?? null,
+    ])).digest('hex');
+}
+const SECRET_KEYS = new Set(['authorization', 'proxyauthorization', 'cookie', 'setcookie', 'password', 'passwd', 'passphrase', 'secret', 'clientsecret', 'token', 'accesstoken', 'refreshtoken', 'idtoken', 'apikey', 'xapikey', 'privatekey', 'credentials', 'headers']);
+/** Header objects are deliberately wholly redacted, rather than guessing safe headers. */
+export function redact(value) {
+    if (Array.isArray(value))
+        return value.map(redact);
+    if (value && typeof value === 'object') {
+        const result = Object.create(null);
+        for (const [key, child] of Object.entries(value)) {
+            const normalized = key.toLowerCase().replace(/[^a-z0-9]/g, '');
+            result[key] = SECRET_KEYS.has(normalized) || /(?:password|secret|token|apikey)$/.test(normalized) ? '[REDACTED]' : redact(child);
+        }
+        return result;
+    }
+    return value;
+}
+/** Useful to host stdout parsers too: bounded fragments, including oversize lines. */
+export class JsonlDecoder {
+    onRecord;
+    registry;
+    pending = Buffer.alloc(0);
+    skipping = false;
+    constructor(onRecord, registry = defaultLogRegistry) {
+        this.onRecord = onRecord;
+        this.registry = registry;
+    }
+    push(chunk, startOffset = 0) {
+        const bytes = typeof chunk === 'string' ? Buffer.from(chunk) : chunk;
+        let start = 0;
+        for (let i = 0; i < bytes.length; i++) {
+            if (bytes[i] !== 10)
+                continue;
+            if (!this.skipping) {
+                const fragment = bytes.subarray(start, i);
+                if (this.pending.length + fragment.length <= MAX_LOG_LINE_BYTES) {
+                    const line = this.pending.length ? Buffer.concat([this.pending, fragment]) : fragment;
+                    const record = parseLogLine(line.toString('utf8'), this.registry);
+                    if (record)
+                        this.onRecord(record, startOffset + i + 1);
+                }
+            }
+            this.pending = Buffer.alloc(0);
+            this.skipping = false;
+            start = i + 1;
+        }
+        const rest = bytes.subarray(start);
+        if (!this.skipping && this.pending.length + rest.length <= MAX_LOG_LINE_BYTES)
+            this.pending = Buffer.concat([this.pending, rest]);
+        else {
+            this.pending = Buffer.alloc(0);
+            this.skipping = true;
+        }
+    }
+    reset() { this.pending = Buffer.alloc(0); this.skipping = false; }
+    discardPartialLine() { this.pending = Buffer.alloc(0); this.skipping = true; }
+    get pendingBytes() { return this.pending.length; }
+}
+//# sourceMappingURL=standard.js.map

package/dist/monitoring/standard.js.map

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

package/dist/monitoring/tailer.d.ts

@@ -0,0 +1,41 @@
+import { type StandardLogRecord } from './standard.js';
+import type { LogPointer } from './error-buffer.js';
+export interface LogTailerOptions {
+    logsPath: string;
+    onRecord: (record: StandardLogRecord, pointer: LogPointer) => unknown | Promise<unknown>;
+    /** Existing history is skipped by default. Newly created files always start at zero. */
+    readExisting?: boolean;
+    pollMs?: number;
+    run?: LogPointer['run'];
+    /** Optional durable completed-line cursor; ErrorBuffer event IDs dedup replay. */
+    cursorPath?: string;
+    onError?: (error: unknown) => void;
+}
+/** Bounded file reads, inode-aware rotation, truncation and partial-line handling. */
+export declare class LogTailer {
+    private readonly options;
+    readonly ready: Promise<void>;
+    private path;
+    private handle?;
+    private identity?;
+    private offset;
+    private committed;
+    private cursor?;
+    private first;
+    private closed;
+    private timer?;
+    private work;
+    private decoder;
+    private records;
+    constructor(options: LogTailerOptions);
+    private report;
+    private start;
+    /** Exposed for deterministic shutdown/tests; overlapping polls serialize. */
+    poll(): Promise<void>;
+    private attach;
+    private readAvailable;
+    private persistCursor;
+    private tick;
+    close(): Promise<void>;
+}
+export { LogTailer as JsonlMonitor };