@vibesdotdev/logging 0.0.1 → 1.0.0-rc.4

package/dist/host-files/file-output.base.js

@@ -0,0 +1,401 @@
+/**
+ * The `file` output (and each named file stream it creates) over the host's
+ * file primitives (`LoggingFileHost`): buffered ordered appends, size and age
+ * rotation, retention, reads, tails and the copy-truncate rotation of a file
+ * another process appends to. `fileOutputFor(host)` is the class a host
+ * registers; every stream it creates is that same class.
+ */
+import { OutputDescriptorSchema, resolveFileOutputRotation, resolveOutputBuffering, JsonlFormatter, jsonlFormatterDescriptor, createFallbackLogger, LoggedErrorSchema, trackLoggingResource, untrackLoggingResource, getCapturedLoggingConfig, parseSize, parseDuration, attempt, isMissingPath } from "../host.js";
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { readLines, tailFile } from "./file-output.read.base.js";
+import { rotateAppendedFileOn } from "./rotate-appended-file.base.js";
+const ARCHIVE_SUFFIX = /^\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z(?:\.\d+)?$/;
+const encoder = new TextEncoder();
+export class FileOutputBase {
+    id;
+    host;
+    descriptor;
+    formatter;
+    filePath;
+    rotation;
+    buffering;
+    runtime;
+    context;
+    buffer = [];
+    bufferBytes = 0;
+    file = null;
+    flushPromise = null;
+    closePromise = null;
+    closing = false;
+    tails = new Set();
+    acceptedLines = new Set();
+    pendingDiagnostics = new Set();
+    diagnosticFailures = [];
+    rotationSequence = 0;
+    /** The one-shot flush pending for the current buffer (lifecycle-owned). */
+    flushDisposer = null;
+    /** The retention tick on a persistent host (lifecycle-owned). */
+    retentionDisposer = null;
+    currentSize = 0;
+    writeQueue = Promise.resolve();
+    constructor(host, descriptor, context) {
+        this.host = host;
+        this.descriptor = OutputDescriptorSchema.parse(descriptor);
+        this.id = this.descriptor.id;
+        const runtime = context.runtime;
+        this.runtime = runtime;
+        this.context = context;
+        this.formatter = context.formatter ?? new JsonlFormatter(jsonlFormatterDescriptor, { runtime });
+        // Only a relative file destination needs the host's bound workspace root.
+        if (descriptor.path && host.isAbsolute(descriptor.path)) {
+            this.filePath = descriptor.path;
+        }
+        else {
+            const basePath = context['runtime/workspace-path'];
+            if (!basePath)
+                throw new CapabilityError('A relative file output requires its descriptor-injected workspace.', 'NOT_FOUND', {
+                    reason: 'workspace-unbound', details: { kind: 'context', id: 'runtime/workspace-path' }, retryable: false
+                });
+            this.filePath = host.join(basePath, descriptor.path ?? 'logs/app.log');
+        }
+        this.rotation = resolveFileOutputRotation(runtime, descriptor);
+        this.buffering = resolveOutputBuffering(descriptor.buffering);
+        // Retention runs as a lifecycle-owned tick only on a persistent host. A
+        // finite host starts no background work (`lifecycle.interval` refuses
+        // it); its rotated files are bounded at every rotation instead.
+        if (runtime.scope.lifecycle !== 'finite') {
+            const cleanupIntervalMs = getCapturedLoggingConfig(runtime).retentionCleanupIntervalMs;
+            this.retentionDisposer = runtime.lifecycle.interval(() => {
+                this.diagnose(this.enforceRetention().then(() => undefined), 'Retention failed', { path: this.filePath });
+            }, cleanupIntervalMs);
+        }
+        trackLoggingResource(runtime, this);
+    }
+    /**
+     * Report a background operation's failure through the fallback logger. A
+     * failure that cannot be reported is kept and raised by `close`.
+     */
+    diagnose(operation, message, context) {
+        const completed = attempt(() => operation).then(async (settled) => {
+            if (!('failure' in settled))
+                return;
+            const failure = settled.failure.cause;
+            const reported = await attempt(async () => {
+                (await createFallbackLogger('logging:file-output', this.runtime)).error(message, {
+                    ...context, error: LoggedErrorSchema.parse(failure)
+                });
+            });
+            if ('failure' in reported)
+                this.diagnosticFailures.push(LoggedErrorSchema.parse(reported.failure.cause));
+        });
+        this.pendingDiagnostics.add(completed);
+        void completed.then(() => this.pendingDiagnostics.delete(completed));
+    }
+    assertWritable() {
+        if (this.closing || this.runtime.lifecycle.signal.aborted) {
+            throw new CapabilityError('The file output no longer accepts writes.', 'UNAVAILABLE', {
+                reason: this.closing ? 'output-closed' : 'output-runtime-disposed',
+                details: { id: this.id }, cause: this.runtime.lifecycle.signal.reason
+            });
+        }
+    }
+    async write(entry) {
+        this.assertWritable();
+        await this.enqueue(`${this.formatter.format(entry)}\n`);
+    }
+    async writeBatch(entries) {
+        this.assertWritable();
+        for (const entry of entries)
+            await this.write(entry);
+    }
+    async enqueue(chunk) {
+        if (!this.buffering.enabled) {
+            await this.writeChunk(chunk);
+            return;
+        }
+        if (this.buffer.length >= this.buffering.maxBufferEntries) {
+            await this.flush();
+            this.assertWritable();
+            return this.enqueue(chunk);
+        }
+        this.buffer.push(chunk);
+        this.bufferBytes += encoder.encode(chunk).byteLength;
+        if (this.bufferBytes >= this.buffering.size || this.buffer.length >= this.buffering.maxBufferEntries) {
+            await this.flush();
+            return;
+        }
+        this.scheduleFlush();
+    }
+    /** One lifecycle-owned flush per non-empty buffer, `flushInterval` after its first write. */
+    scheduleFlush() {
+        if (this.closing || this.flushDisposer || this.flushPromise || !this.buffering.flushInterval || this.buffer.length === 0)
+            return;
+        if (this.runtime.lifecycle.signal.aborted)
+            return;
+        this.flushDisposer = this.runtime.lifecycle.timeout(() => {
+            this.flushDisposer = null;
+            this.diagnose(this.flush(), 'Flush failed', { path: this.filePath });
+        }, this.buffering.flushInterval);
+    }
+    flush() {
+        this.flushDisposer?.();
+        this.flushDisposer = null;
+        if (this.flushPromise)
+            return this.flushPromise;
+        if (this.buffer.length === 0)
+            return Promise.resolve();
+        const count = this.buffer.length;
+        this.flushPromise = (async () => {
+            for (let index = 0; index < count; index++) {
+                const chunk = this.buffer[0];
+                if (chunk === undefined)
+                    break;
+                await this.writeChunk(chunk);
+                this.buffer.shift();
+                this.bufferBytes -= encoder.encode(chunk).byteLength;
+            }
+        })().then(() => {
+            this.flushPromise = null;
+            this.scheduleFlush();
+        }, error => {
+            this.flushPromise = null;
+            throw error;
+        });
+        return this.flushPromise;
+    }
+    close() {
+        if (this.closePromise)
+            return this.closePromise;
+        this.closing = true;
+        this.flushDisposer?.();
+        this.flushDisposer = null;
+        this.retentionDisposer?.();
+        this.retentionDisposer = null;
+        const tails = [...this.tails].map(tail => tail.close());
+        this.tails.clear();
+        this.closePromise = (async () => {
+            const drained = await Promise.allSettled([...tails, ...this.acceptedLines, ...this.pendingDiagnostics, (async () => {
+                    if (this.flushPromise)
+                        await this.flushPromise;
+                    await this.flush();
+                })()]);
+            const ended = await Promise.allSettled([this.serialized(() => this.endFile())]);
+            const failures = [...drained, ...ended].filter(result => result.status === 'rejected').map(result => result.reason).concat(this.diagnosticFailures);
+            if (failures.length === 1)
+                throw failures[0];
+            if (failures.length > 1)
+                throw new AggregateError(failures, 'File output cleanup failed.');
+            untrackLoggingResource(this.runtime, this);
+        })();
+        return this.closePromise;
+    }
+    /** Run `work` in write order, after every write queued before it. */
+    serialized(work) {
+        const run = this.writeQueue.then(work);
+        // The queue only orders work: the next item waits for this one to
+        // settle, and this item's failure reaches its caller through `run`.
+        this.writeQueue = Promise.allSettled([run]).then(() => undefined);
+        return run;
+    }
+    async endFile() {
+        const file = this.file;
+        if (!file)
+            return;
+        this.file = null;
+        await file.close();
+    }
+    /** Close the active file, archive it as `<file>.<timestamp>` and bound the archives; `null` when there was no active file. */
+    async rotate() {
+        this.assertWritable();
+        await this.flush();
+        return this.serialized(() => this.rotateActiveFile());
+    }
+    /** Rotation itself; runs only inside the write queue, so it never flushes back into it. */
+    async rotateActiveFile() {
+        await this.endFile();
+        // Only a rotation that happened is reported: with no active file there is nothing archived.
+        let archived = null;
+        if (this.host.exists(this.filePath)) {
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            archived = `${this.filePath}.${timestamp}.${String(this.rotationSequence++).padStart(12, '0')}`;
+            await this.host.rename(this.filePath, archived);
+        }
+        await this.cleanupOldFiles();
+        return { archived };
+    }
+    async enforceRetention() {
+        this.assertWritable();
+        await this.maybeRotateStaleActiveFile();
+        return this.serialized(async () => ({ removed: await this.cleanupOldFiles() }));
+    }
+    async read(options) {
+        return readLines(this.host, this.filePath, options);
+    }
+    tail(callback, options) {
+        this.assertWritable();
+        const native = tailFile(this.host, this.filePath, callback, options, async (error) => {
+            (await createFallbackLogger('logging:file-tail', this.runtime)).error('File tail failed', { path: this.filePath, error });
+        });
+        this.tails.add(native);
+        return {
+            close: () => {
+                this.diagnose(native.close().then(() => { this.tails.delete(native); }), 'Tail cleanup failed', { id: this.id });
+            }
+        };
+    }
+    async stats() {
+        const statted = await attempt(() => this.host.stat(this.filePath));
+        if ('failure' in statted) {
+            if (isMissingPath(statted.failure))
+                return { size: 0, exists: false };
+            throw statted.failure.cause;
+        }
+        return { size: statted.value.size, modifiedAt: statted.value.mtime, exists: true };
+    }
+    async writeLine(line) {
+        this.assertWritable();
+        // Admission occurs before waiting for a captured fragment to be classified.
+        // Disposal joins this accepted work; it cannot admit another reservation.
+        const accepted = (async () => {
+            const chunk = await line;
+            if (chunk === null)
+                return;
+            await this.flush();
+            await this.writeChunk(chunk);
+        })();
+        this.acceptedLines.add(accepted);
+        try {
+            await accepted;
+        }
+        finally {
+            this.acceptedLines.delete(accepted);
+        }
+    }
+    /** A separately configured file stream on this output's Runtime. */
+    async create(descriptor, namedContext) {
+        if (namedContext.runtime.lifecycle !== this.runtime.lifecycle)
+            throw new CapabilityError('A file stream context belongs to another Runtime.', 'CONFLICT', {
+                reason: 'output-context-runtime-mismatch', retryable: false
+            });
+        return new (fileOutputFor(this.host))(OutputDescriptorSchema.parse(descriptor), { ...this.context, ...namedContext, runtime: this.runtime });
+    }
+    /** Admit a line now; write it once classified (`null` writes nothing). */
+    async writeReservedLine(line) {
+        return this.writeLine(line);
+    }
+    /** Copy-truncate rotation for a file another process appends to (L1). */
+    async rotateAppendedFile(path, policy) {
+        return rotateAppendedFileOn(this.host, path, policy);
+    }
+    async writeChunk(chunk) {
+        const bytes = encoder.encode(chunk).byteLength;
+        await this.serialized(async () => {
+            let file = await this.ensureFile();
+            if (this.shouldRotateBySize(bytes)) {
+                await this.rotateActiveFile();
+                file = await this.ensureFile();
+            }
+            await file.writeFile(chunk);
+            this.currentSize += bytes;
+        });
+    }
+    async ensureFile() {
+        if (this.file)
+            return this.file;
+        await this.host.mkdirRecursive(this.host.dirname(this.filePath));
+        const file = await this.host.open(this.filePath, 'a');
+        try {
+            this.currentSize = (await file.stat()).size;
+        }
+        catch (error) {
+            await file.close();
+            throw error;
+        }
+        this.file = file;
+        return file;
+    }
+    shouldRotateBySize(additionalBytes) {
+        const maxBytes = parseSize(this.rotation.maxSize);
+        // An empty file never rotates: a single chunk larger than the cap is
+        // written whole rather than rotating forever.
+        return this.currentSize > 0 && this.currentSize + additionalBytes > maxBytes;
+    }
+    async maybeRotateStaleActiveFile() {
+        if (!this.rotation.maxAge)
+            return;
+        const statted = await attempt(() => this.host.stat(this.filePath));
+        if ('failure' in statted) {
+            if (isMissingPath(statted.failure))
+                return;
+            throw statted.failure.cause;
+        }
+        const fileStats = statted.value;
+        if (fileStats.size === 0)
+            return;
+        const maxAgeMs = parseDuration(this.rotation.maxAge);
+        if (Date.now() - fileStats.mtimeMs >= maxAgeMs) {
+            await this.rotate();
+        }
+    }
+    async cleanupOldFiles() {
+        const dir = this.host.dirname(this.filePath);
+        const name = this.host.basename(this.filePath);
+        const prefix = `${name}.`;
+        let removed = 0;
+        const listed = await attempt(() => this.host.readdir(dir));
+        if ('failure' in listed) {
+            if (isMissingPath(listed.failure))
+                return 0;
+            throw listed.failure.cause;
+        }
+        const rotatedFiles = listed.value
+            .filter((file) => file.startsWith(prefix) && ARCHIVE_SUFFIX.test(file.slice(prefix.length)))
+            .sort()
+            .reverse();
+        const removedFiles = new Set();
+        const removeRotated = async (file) => {
+            const unlinked = await attempt(() => this.host.unlink(this.host.join(dir, file)));
+            if ('value' in unlinked)
+                removed++;
+            // A missing archive means another process's cleanup got there first.
+            else if (!isMissingPath(unlinked.failure))
+                throw unlinked.failure.cause;
+            removedFiles.add(file);
+        };
+        for (const file of rotatedFiles.slice(this.rotation.maxFiles)) {
+            await removeRotated(file);
+        }
+        if (this.rotation.maxAge) {
+            const maxAgeMs = parseDuration(this.rotation.maxAge);
+            const cutoff = Date.now() - maxAgeMs;
+            for (const file of rotatedFiles) {
+                if (removedFiles.has(file))
+                    continue;
+                const statted = await attempt(() => this.host.stat(this.host.join(dir, file)));
+                if ('failure' in statted) {
+                    if (isMissingPath(statted.failure))
+                        continue;
+                    throw statted.failure.cause;
+                }
+                if (statted.value.mtimeMs < cutoff)
+                    await removeRotated(file);
+            }
+        }
+        return removed;
+    }
+}
+const fileOutputClasses = new WeakMap();
+/** The file output class over `host`, one per host, so every stream it creates is the same class. */
+export function fileOutputFor(host) {
+    let bound = fileOutputClasses.get(host);
+    if (!bound) {
+        bound = class FileOutput extends FileOutputBase {
+            constructor(descriptor, context) {
+                super(host, descriptor, context);
+            }
+        };
+        fileOutputClasses.set(host, bound);
+    }
+    return bound;
+}
+//# sourceMappingURL=file-output.base.js.map

package/dist/host-files/file-output.base.js.map

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

package/dist/host-files/file-output.factory.base.d.ts

@@ -0,0 +1,31 @@
+import { type RuntimeLogEntry, DefaultOutputImplementation, type FileOutputImplementation, type AppendedFileRotation, type AppendedFileRotationPolicy, type OutputContext, type OutputDescriptor } from '../host.ts';
+import type { LoggingFileHost } from '../schemas/file-host.ts';
+import { type FileOutputBase } from './file-output.base.ts';
+/** The Runtime selects the factory before any stream opens a file. */
+export declare class FileOutputFactoryBase extends DefaultOutputImplementation implements FileOutputImplementation {
+    private readonly host;
+    /** This backend's own stream: the one file stream its write, read and rotation methods share. */
+    private stream;
+    private opening;
+    constructor(host: LoggingFileHost, ...backend: ConstructorParameters<typeof DefaultOutputImplementation>);
+    create(descriptor: OutputDescriptor, namedContext: OutputContext): Promise<FileOutputBase>;
+    /** The backend's own stream, created from its declared descriptor: typed, never narrowed at run time. */
+    protected getDelegatePromise(): Promise<FileOutputBase>;
+    private getFileDelegate;
+    writeBatch(entries: RuntimeLogEntry[]): Promise<void>;
+    writeLine(line: string): Promise<void>;
+    writeReservedLine(line: Promise<string | null>): Promise<void>;
+    /** Rotates a path another process appends to; it opens no stream. */
+    rotateAppendedFile(path: string, policy: AppendedFileRotationPolicy): Promise<AppendedFileRotation>;
+    rotate(): Promise<{
+        archived: string | null;
+    }>;
+    enforceRetention(): Promise<{
+        removed: number;
+    }>;
+}
+type FileOutputFactoryClass = new (...backend: ConstructorParameters<typeof DefaultOutputImplementation>) => FileOutputFactoryBase;
+/** The `file` output backend class over `host`, one per host. */
+export declare function fileOutputFactoryFor(host: LoggingFileHost): FileOutputFactoryClass;
+export {};
+//# sourceMappingURL=file-output.factory.base.d.ts.map

package/dist/host-files/file-output.factory.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-output.factory.base.d.ts","sourceRoot":"","sources":["../../src/host-files/file-output.factory.base.ts"],"names":[],"mappings":"AAOA,OAAO,EACN,KAAK,eAAe,EACpB,2BAA2B,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,aAAa,EAElB,KAAK,gBAAgB,EAErB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG3E,sEAAsE;AACtE,qBAAa,qBAAsB,SAAQ,2BAA4B,YAAW,wBAAwB;IACzG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,iGAAiG;IACjG,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,OAAO,CAAwC;gBAE3C,IAAI,EAAE,eAAe,EAAE,GAAG,OAAO,EAAE,qBAAqB,CAAC,OAAO,2BAA2B,CAAC;IAKlG,MAAM,CAAC,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAQhG,yGAAyG;cACtF,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC;IAchE,OAAO,CAAC,eAAe;IAIjB,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,qEAAqE;IAC/D,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAInG,MAAM,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAI9C,gBAAgB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAGtD;AAED,KAAK,sBAAsB,GAAG,KAAK,GAAG,OAAO,EAAE,qBAAqB,CAAC,OAAO,2BAA2B,CAAC,KAAK,qBAAqB,CAAC;AAInI,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,sBAAsB,CAWlF"}

package/dist/host-files/file-output.factory.base.js

@@ -0,0 +1,82 @@
+/**
+ * The `file` output backend the Runtime selects (and the `mcp-stdout-capture`
+ * storage it backs), over the host's file primitives: it creates the host's
+ * file streams (`fileOutputFor(host)`) and rotates appended files.
+ * `fileOutputFactoryFor(host)` is the class a host registers.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { DefaultOutputImplementation, OutputDescriptorSchema, captureLoggingConfig } from "../host.js";
+import { fileOutputFor } from "./file-output.base.js";
+import { rotateAppendedFileOn } from "./rotate-appended-file.base.js";
+/** The Runtime selects the factory before any stream opens a file. */
+export class FileOutputFactoryBase extends DefaultOutputImplementation {
+    host;
+    /** This backend's own stream: the one file stream its write, read and rotation methods share. */
+    stream = null;
+    opening = null;
+    constructor(host, ...backend) {
+        super(...backend);
+        this.host = host;
+    }
+    async create(descriptor, namedContext) {
+        if (namedContext.runtime.lifecycle !== this.context.runtime.lifecycle)
+            throw new CapabilityError('A file stream context belongs to another Runtime.', 'CONFLICT', {
+                reason: 'output-context-runtime-mismatch', retryable: false
+            });
+        await captureLoggingConfig(this.context.runtime);
+        return new (fileOutputFor(this.host))(OutputDescriptorSchema.parse(descriptor), { ...this.context, ...namedContext, runtime: this.context.runtime });
+    }
+    /** The backend's own stream, created from its declared descriptor: typed, never narrowed at run time. */
+    getDelegatePromise() {
+        if (this.stream)
+            return Promise.resolve(this.stream);
+        if (!this.opening) {
+            const opening = this.create(this.descriptor, this.context).then((stream) => {
+                this.stream = stream;
+                return stream;
+            }).finally(() => {
+                if (this.opening === opening)
+                    this.opening = null;
+            });
+            this.opening = opening;
+        }
+        return this.opening;
+    }
+    getFileDelegate() {
+        return this.getDelegatePromise();
+    }
+    async writeBatch(entries) {
+        return (await this.getFileDelegate()).writeBatch(entries);
+    }
+    async writeLine(line) {
+        return (await this.getFileDelegate()).writeLine(line);
+    }
+    async writeReservedLine(line) {
+        return (await this.getFileDelegate()).writeReservedLine(line);
+    }
+    /** Rotates a path another process appends to; it opens no stream. */
+    async rotateAppendedFile(path, policy) {
+        return rotateAppendedFileOn(this.host, path, policy);
+    }
+    async rotate() {
+        return (await this.getFileDelegate()).rotate();
+    }
+    async enforceRetention() {
+        return (await this.getFileDelegate()).enforceRetention();
+    }
+}
+const factoryClasses = new WeakMap();
+/** The `file` output backend class over `host`, one per host. */
+export function fileOutputFactoryFor(host) {
+    let bound = factoryClasses.get(host);
+    if (!bound) {
+        bound = class FileOutputFactory extends FileOutputFactoryBase {
+            constructor(...backend) {
+                super(host, ...backend);
+            }
+        };
+        factoryClasses.set(host, bound);
+    }
+    return bound;
+}
+//# sourceMappingURL=file-output.factory.base.js.map

package/dist/host-files/file-output.factory.base.js.map

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

package/dist/host-files/file-output.read.base.d.ts

@@ -0,0 +1,7 @@
+import type { OutputReadOptions, OutputTailOptions } from '../kinds/output.types.ts';
+import { type LoggedError } from '../core/redact.ts';
+import type { FileTailHandle, LoggingFileHost } from '../schemas/file-host.ts';
+export declare function readLines(host: LoggingFileHost, filePath: string, options?: OutputReadOptions): Promise<string[]>;
+/** Native directory events follow both appends and replacement of the active file. */
+export declare function tailFile(host: LoggingFileHost, filePath: string, callback: (line: string) => void, options: OutputTailOptions | undefined, reportError: (error: LoggedError) => Promise<void>): FileTailHandle;
+//# sourceMappingURL=file-output.read.base.d.ts.map

package/dist/host-files/file-output.read.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-output.read.base.d.ts","sourceRoot":"","sources":["../../src/host-files/file-output.read.base.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,KAAK,EAAE,cAAc,EAA4C,eAAe,EAAE,MAAM,yBAAyB,CAAC;AA4BzH,wBAAsB,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBvH;AAMD,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,OAAO,EAAE,iBAAiB,GAAG,SAAS,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,cAAc,CA+I9M"}