@herdctl/core 0.0.1 → 0.1.0

package/dist/fleet-manager/job-control.js.map

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

package/dist/fleet-manager/log-streaming.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Log Streaming Module (US-8)
+ *
+ * Provides log streaming functionality as async generators for the FleetManager.
+ * Isolates the async generator patterns for streaming logs from agents, jobs,
+ * and the fleet.
+ *
+ * This module provides three main streaming functions:
+ * - `streamLogs` - Stream all fleet logs with filtering options
+ * - `streamJobOutput` - Stream output from a specific job
+ * - `streamAgentLogs` - Stream logs for a specific agent
+ */
+import type { JobMetadata } from "../state/schemas/job-metadata.js";
+import type { LogLevel, LogEntry, LogStreamOptions } from "./types.js";
+import type { FleetManagerContext } from "./context.js";
+/**
+ * LogStreaming provides log streaming operations for the FleetManager.
+ *
+ * This class encapsulates the logic for streaming logs from agents, jobs,
+ * and the fleet using the FleetManagerContext pattern.
+ */
+export declare class LogStreaming {
+    private ctx;
+    constructor(ctx: FleetManagerContext);
+    private getDeps;
+    /**
+     * Stream all fleet logs as an async iterable
+     *
+     * Provides a unified stream of logs from all sources in the fleet including
+     * agents, jobs, and the scheduler. Logs can be filtered by level and optionally
+     * by agent or job.
+     *
+     * @param options - Options for filtering and configuring the stream
+     * @returns An async iterable of LogEntry objects
+     */
+    streamLogs(options?: LogStreamOptions): AsyncIterable<LogEntry>;
+    /**
+     * Stream output from a specific job as an async iterable
+     *
+     * @param jobId - The ID of the job to stream output from
+     * @returns An async iterable of LogEntry objects
+     * @throws {JobNotFoundError} If the job doesn't exist
+     */
+    streamJobOutput(jobId: string): AsyncIterable<LogEntry>;
+    /**
+     * Stream logs for a specific agent as an async iterable
+     *
+     * @param agentName - The name of the agent to stream logs for
+     * @returns An async iterable of LogEntry objects
+     * @throws {AgentNotFoundError} If the agent doesn't exist in the configuration
+     */
+    streamAgentLogs(agentName: string): AsyncIterable<LogEntry>;
+}
+/**
+ * Convert a job output message to a LogEntry
+ *
+ * Transforms raw job output (as stored in JSONL files) into a structured
+ * LogEntry for the streaming API.
+ *
+ * @param job - The job metadata
+ * @param msg - The raw output message
+ * @returns A LogEntry representing the message
+ */
+export declare function jobOutputToLogEntry(job: JobMetadata, msg: {
+    type: string;
+    content?: string;
+    timestamp?: string;
+}): LogEntry;
+/**
+ * Determine if a log entry should be yielded based on filters
+ *
+ * Checks log level, agent name, and job ID filters to determine
+ * if an entry should be included in the stream.
+ *
+ * @param entry - The log entry to check
+ * @param minLevel - Minimum log level to include
+ * @param agentFilter - Optional agent name filter
+ * @param jobFilter - Optional job ID filter
+ * @returns True if the entry should be yielded
+ */
+export declare function shouldYieldLog(entry: LogEntry, minLevel: LogLevel, agentFilter?: string, jobFilter?: string): boolean;
+/**
+ * Get the log level order value
+ *
+ * Utility function to get the numeric ordering of a log level.
+ *
+ * @param level - The log level
+ * @returns The numeric ordering (0=debug, 1=info, 2=warn, 3=error)
+ */
+export declare function getLogLevelOrder(level: LogLevel): number;
+/**
+ * Compare two log levels
+ *
+ * @param a - First log level
+ * @param b - Second log level
+ * @returns Negative if a < b, 0 if equal, positive if a > b
+ */
+export declare function compareLogLevels(a: LogLevel, b: LogLevel): number;
+/**
+ * Check if a log level meets the minimum threshold
+ *
+ * @param level - The log level to check
+ * @param minLevel - The minimum required level
+ * @returns True if level >= minLevel
+ */
+export declare function meetsLogLevel(level: LogLevel, minLevel: LogLevel): boolean;
+/**
+ * Filter log entries by level
+ *
+ * Creates a filtering function that only passes logs at or above
+ * the specified level.
+ *
+ * @param minLevel - Minimum log level to include
+ * @returns A filter function
+ */
+export declare function createLogLevelFilter(minLevel: LogLevel): (entry: LogEntry) => boolean;
+/**
+ * Filter log entries by agent
+ *
+ * Creates a filtering function that only passes logs from
+ * the specified agent.
+ *
+ * @param agentName - Agent name to filter by
+ * @returns A filter function
+ */
+export declare function createAgentFilter(agentName: string): (entry: LogEntry) => boolean;
+/**
+ * Filter log entries by job
+ *
+ * Creates a filtering function that only passes logs from
+ * the specified job.
+ *
+ * @param jobId - Job ID to filter by
+ * @returns A filter function
+ */
+export declare function createJobFilter(jobId: string): (entry: LogEntry) => boolean;
+/**
+ * Combine multiple log filters
+ *
+ * Creates a filter that passes only if all provided filters pass.
+ *
+ * @param filters - Array of filter functions
+ * @returns A combined filter function
+ */
+export declare function combineLogFilters(...filters: ((entry: LogEntry) => boolean)[]): (entry: LogEntry) => boolean;
+/**
+ * Create a log entry from raw data
+ *
+ * Factory function for creating LogEntry objects with proper defaults.
+ *
+ * @param data - Partial log entry data
+ * @returns A complete LogEntry
+ */
+export declare function createLogEntry(data: Partial<LogEntry> & {
+    message: string;
+}): LogEntry;
+/**
+ * Format a log entry as a string
+ *
+ * Creates a human-readable string representation of a log entry.
+ *
+ * @param entry - The log entry to format
+ * @param options - Formatting options
+ * @returns A formatted string
+ */
+export declare function formatLogEntry(entry: LogEntry, options?: {
+    includeTimestamp?: boolean;
+    includeSource?: boolean;
+    includeContext?: boolean;
+}): string;
+//# sourceMappingURL=log-streaming.d.ts.map

package/dist/fleet-manager/log-streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-streaming.d.ts","sourceRoot":"","sources":["../../src/fleet-manager/log-streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAEV,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA+BxD;;;;;GAKG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,mBAAmB;IAE5C,OAAO,CAAC,OAAO;IASf;;;;;;;;;OASG;IACI,UAAU,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,CAAC,QAAQ,CAAC;IAItE;;;;;;OAMG;IACI,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC;IAI9D;;;;;;OAMG;IACI,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC;CAGnE;AAMD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,QAAQ,CAmBV;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,QAAQ,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAiBT;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE1E;AAgSD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,GACjB,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAE9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,GAChB,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAE9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAE3E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,EAAE,GAC3C,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAE9B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5C,QAAQ,CAWV;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE;IACR,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GACA,MAAM,CAyBR"}

package/dist/fleet-manager/log-streaming.js

@@ -0,0 +1,503 @@
+/**
+ * Log Streaming Module (US-8)
+ *
+ * Provides log streaming functionality as async generators for the FleetManager.
+ * Isolates the async generator patterns for streaming logs from agents, jobs,
+ * and the fleet.
+ *
+ * This module provides three main streaming functions:
+ * - `streamLogs` - Stream all fleet logs with filtering options
+ * - `streamJobOutput` - Stream output from a specific job
+ * - `streamAgentLogs` - Stream logs for a specific agent
+ */
+import { join } from "node:path";
+import { AgentNotFoundError, JobNotFoundError } from "./errors.js";
+// =============================================================================
+// Constants
+// =============================================================================
+/**
+ * Log level severity ordering for filtering
+ */
+const LOG_LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+/**
+ * LogStreaming provides log streaming operations for the FleetManager.
+ *
+ * This class encapsulates the logic for streaming logs from agents, jobs,
+ * and the fleet using the FleetManagerContext pattern.
+ */
+export class LogStreaming {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    getDeps() {
+        return {
+            stateDir: this.ctx.getStateDir(),
+            config: this.ctx.getConfig(),
+            logger: this.ctx.getLogger(),
+            emitter: this.ctx.getEmitter(),
+        };
+    }
+    /**
+     * Stream all fleet logs as an async iterable
+     *
+     * Provides a unified stream of logs from all sources in the fleet including
+     * agents, jobs, and the scheduler. Logs can be filtered by level and optionally
+     * by agent or job.
+     *
+     * @param options - Options for filtering and configuring the stream
+     * @returns An async iterable of LogEntry objects
+     */
+    async *streamLogs(options) {
+        yield* streamLogsImpl(this.getDeps(), options);
+    }
+    /**
+     * Stream output from a specific job as an async iterable
+     *
+     * @param jobId - The ID of the job to stream output from
+     * @returns An async iterable of LogEntry objects
+     * @throws {JobNotFoundError} If the job doesn't exist
+     */
+    async *streamJobOutput(jobId) {
+        yield* streamJobOutputImpl(this.getDeps(), jobId);
+    }
+    /**
+     * Stream logs for a specific agent as an async iterable
+     *
+     * @param agentName - The name of the agent to stream logs for
+     * @returns An async iterable of LogEntry objects
+     * @throws {AgentNotFoundError} If the agent doesn't exist in the configuration
+     */
+    async *streamAgentLogs(agentName) {
+        yield* streamAgentLogsImpl(this.getDeps(), agentName);
+    }
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Convert a job output message to a LogEntry
+ *
+ * Transforms raw job output (as stored in JSONL files) into a structured
+ * LogEntry for the streaming API.
+ *
+ * @param job - The job metadata
+ * @param msg - The raw output message
+ * @returns A LogEntry representing the message
+ */
+export function jobOutputToLogEntry(job, msg) {
+    // Determine log level based on message type
+    let level = "info";
+    if (msg.type === "error") {
+        level = "error";
+    }
+    else if (msg.type === "system") {
+        level = "debug";
+    }
+    return {
+        timestamp: msg.timestamp ?? new Date().toISOString(),
+        level,
+        source: "job",
+        agentName: job.agent,
+        jobId: job.id,
+        scheduleName: job.schedule ?? undefined,
+        message: msg.content ?? "",
+        data: { type: msg.type },
+    };
+}
+/**
+ * Determine if a log entry should be yielded based on filters
+ *
+ * Checks log level, agent name, and job ID filters to determine
+ * if an entry should be included in the stream.
+ *
+ * @param entry - The log entry to check
+ * @param minLevel - Minimum log level to include
+ * @param agentFilter - Optional agent name filter
+ * @param jobFilter - Optional job ID filter
+ * @returns True if the entry should be yielded
+ */
+export function shouldYieldLog(entry, minLevel, agentFilter, jobFilter) {
+    // Check log level
+    if (LOG_LEVEL_ORDER[entry.level] < LOG_LEVEL_ORDER[minLevel]) {
+        return false;
+    }
+    // Check agent filter
+    if (agentFilter && entry.agentName !== agentFilter) {
+        return false;
+    }
+    // Check job filter
+    if (jobFilter && entry.jobId !== jobFilter) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Get the log level order value
+ *
+ * Utility function to get the numeric ordering of a log level.
+ *
+ * @param level - The log level
+ * @returns The numeric ordering (0=debug, 1=info, 2=warn, 3=error)
+ */
+export function getLogLevelOrder(level) {
+    return LOG_LEVEL_ORDER[level];
+}
+/**
+ * Compare two log levels
+ *
+ * @param a - First log level
+ * @param b - Second log level
+ * @returns Negative if a < b, 0 if equal, positive if a > b
+ */
+export function compareLogLevels(a, b) {
+    return LOG_LEVEL_ORDER[a] - LOG_LEVEL_ORDER[b];
+}
+/**
+ * Check if a log level meets the minimum threshold
+ *
+ * @param level - The log level to check
+ * @param minLevel - The minimum required level
+ * @returns True if level >= minLevel
+ */
+export function meetsLogLevel(level, minLevel) {
+    return LOG_LEVEL_ORDER[level] >= LOG_LEVEL_ORDER[minLevel];
+}
+// =============================================================================
+// Internal Streaming Implementation Functions
+// =============================================================================
+/**
+ * Internal implementation for streaming fleet logs
+ */
+async function* streamLogsImpl(deps, options) {
+    const level = options?.level ?? "info";
+    const includeHistory = options?.includeHistory ?? true;
+    const historyLimit = options?.historyLimit ?? 1000;
+    const agentFilter = options?.agentName;
+    const jobFilter = options?.jobId;
+    const jobsDir = join(deps.stateDir, "jobs");
+    const { readJobOutputAll } = await import("../state/job-output.js");
+    const { listJobs } = await import("../state/index.js");
+    // Replay historical logs if requested
+    if (includeHistory) {
+        // Get jobs to replay history from
+        const jobsResult = await listJobs(jobsDir, agentFilter ? { agent: agentFilter } : {}, { logger: deps.logger });
+        // Filter by job ID if specified
+        let jobs = jobsResult.jobs;
+        if (jobFilter) {
+            jobs = jobs.filter((j) => j.id === jobFilter);
+        }
+        // Sort by started_at ascending to replay in chronological order
+        jobs.sort((a, b) => new Date(a.started_at).getTime() - new Date(b.started_at).getTime());
+        let yielded = 0;
+        for (const job of jobs) {
+            if (yielded >= historyLimit)
+                break;
+            // Read job output and convert to log entries
+            const output = await readJobOutputAll(jobsDir, job.id, {
+                skipInvalidLines: true,
+                logger: deps.logger,
+            });
+            for (const msg of output) {
+                if (yielded >= historyLimit)
+                    break;
+                const logEntry = jobOutputToLogEntry(job, msg);
+                if (shouldYieldLog(logEntry, level, agentFilter, jobFilter)) {
+                    yield logEntry;
+                    yielded++;
+                }
+            }
+        }
+    }
+    // For running jobs, subscribe to job:output events
+    const outputQueue = [];
+    let resolveWait = null;
+    let stopped = false;
+    const outputHandler = (payload) => {
+        if (stopped)
+            return;
+        const logEntry = {
+            timestamp: payload.timestamp,
+            level: "info",
+            source: "job",
+            agentName: payload.agentName,
+            jobId: payload.jobId,
+            message: payload.output,
+        };
+        if (shouldYieldLog(logEntry, level, agentFilter, jobFilter)) {
+            outputQueue.push(logEntry);
+            if (resolveWait) {
+                resolveWait();
+                resolveWait = null;
+            }
+        }
+    };
+    deps.emitter.on("job:output", outputHandler);
+    try {
+        // Yield queued entries as they arrive
+        while (!stopped) {
+            while (outputQueue.length > 0) {
+                const entry = outputQueue.shift();
+                yield entry;
+            }
+            // Wait for more entries
+            await new Promise((resolve) => {
+                resolveWait = resolve;
+                // Add timeout to prevent hanging forever
+                setTimeout(resolve, 1000);
+            });
+        }
+    }
+    finally {
+        stopped = true;
+        deps.emitter.off("job:output", outputHandler);
+    }
+}
+/**
+ * Internal implementation for streaming job output
+ */
+async function* streamJobOutputImpl(deps, jobId) {
+    const jobsDir = join(deps.stateDir, "jobs");
+    const { getJob } = await import("../state/index.js");
+    // Verify job exists
+    const job = await getJob(jobsDir, jobId, { logger: deps.logger });
+    if (!job) {
+        throw new JobNotFoundError(jobId);
+    }
+    const { readJobOutputAll, getJobOutputPath } = await import("../state/job-output.js");
+    const { watch } = await import("node:fs");
+    const { stat } = await import("node:fs/promises");
+    const { createReadStream } = await import("node:fs");
+    const { createInterface } = await import("node:readline");
+    const outputPath = getJobOutputPath(jobsDir, jobId);
+    // First, replay all existing output
+    const existingOutput = await readJobOutputAll(jobsDir, jobId, {
+        skipInvalidLines: true,
+        logger: deps.logger,
+    });
+    for (const msg of existingOutput) {
+        yield jobOutputToLogEntry(job, msg);
+    }
+    // If job is already completed, we're done
+    if (job.status !== "running" && job.status !== "pending") {
+        return;
+    }
+    // For running jobs, watch for new output
+    const outputQueue = [];
+    let resolveWait = null;
+    let stopped = false;
+    let lastReadPosition = 0;
+    // Get current file position
+    try {
+        const stats = await stat(outputPath);
+        lastReadPosition = stats.size;
+    }
+    catch {
+        // File doesn't exist yet
+    }
+    // Watch for file changes
+    let watcher = null;
+    try {
+        watcher = watch(outputPath, async (eventType) => {
+            if (stopped || eventType !== "change")
+                return;
+            try {
+                const currentStats = await stat(outputPath);
+                if (currentStats.size > lastReadPosition) {
+                    // Read new content
+                    const fileStream = createReadStream(outputPath, {
+                        encoding: "utf-8",
+                        start: lastReadPosition,
+                    });
+                    const rl = createInterface({
+                        input: fileStream,
+                        crlfDelay: Infinity,
+                    });
+                    for await (const line of rl) {
+                        if (stopped)
+                            break;
+                        const trimmedLine = line.trim();
+                        if (trimmedLine === "")
+                            continue;
+                        try {
+                            const parsed = JSON.parse(trimmedLine);
+                            const logEntry = jobOutputToLogEntry(job, parsed);
+                            outputQueue.push(logEntry);
+                            if (resolveWait) {
+                                resolveWait();
+                                resolveWait = null;
+                            }
+                        }
+                        catch {
+                            // Skip malformed lines
+                        }
+                    }
+                    rl.close();
+                    fileStream.destroy();
+                    lastReadPosition = currentStats.size;
+                }
+            }
+            catch (err) {
+                deps.logger.warn(`Error reading output file: ${err.message}`);
+            }
+        });
+    }
+    catch {
+        // Can't watch file - might not exist yet
+    }
+    // Poll for job completion
+    const checkJobComplete = async () => {
+        const { getJob: getJobFn } = await import("../state/index.js");
+        const currentJob = await getJobFn(jobsDir, jobId, { logger: deps.logger });
+        return (!currentJob ||
+            (currentJob.status !== "running" && currentJob.status !== "pending"));
+    };
+    try {
+        // Yield queued entries as they arrive
+        while (!stopped) {
+            while (outputQueue.length > 0) {
+                const entry = outputQueue.shift();
+                yield entry;
+            }
+            // Check if job is complete
+            if (await checkJobComplete()) {
+                stopped = true;
+                break;
+            }
+            // Wait for more entries
+            await new Promise((resolve) => {
+                resolveWait = resolve;
+                setTimeout(resolve, 1000);
+            });
+        }
+    }
+    finally {
+        stopped = true;
+        if (watcher) {
+            watcher.close();
+        }
+    }
+}
+/**
+ * Internal implementation for streaming agent logs
+ */
+async function* streamAgentLogsImpl(deps, agentName) {
+    // Verify agent exists
+    const agents = deps.config?.agents ?? [];
+    const agent = agents.find((a) => a.name === agentName);
+    if (!agent) {
+        throw new AgentNotFoundError(agentName, {
+            availableAgents: agents.map((a) => a.name),
+        });
+    }
+    // Delegate to streamLogsImpl with agent filter
+    yield* streamLogsImpl(deps, {
+        agentName,
+        includeHistory: true,
+    });
+}
+// =============================================================================
+// Utility Functions for Log Processing
+// =============================================================================
+/**
+ * Filter log entries by level
+ *
+ * Creates a filtering function that only passes logs at or above
+ * the specified level.
+ *
+ * @param minLevel - Minimum log level to include
+ * @returns A filter function
+ */
+export function createLogLevelFilter(minLevel) {
+    return (entry) => meetsLogLevel(entry.level, minLevel);
+}
+/**
+ * Filter log entries by agent
+ *
+ * Creates a filtering function that only passes logs from
+ * the specified agent.
+ *
+ * @param agentName - Agent name to filter by
+ * @returns A filter function
+ */
+export function createAgentFilter(agentName) {
+    return (entry) => entry.agentName === agentName;
+}
+/**
+ * Filter log entries by job
+ *
+ * Creates a filtering function that only passes logs from
+ * the specified job.
+ *
+ * @param jobId - Job ID to filter by
+ * @returns A filter function
+ */
+export function createJobFilter(jobId) {
+    return (entry) => entry.jobId === jobId;
+}
+/**
+ * Combine multiple log filters
+ *
+ * Creates a filter that passes only if all provided filters pass.
+ *
+ * @param filters - Array of filter functions
+ * @returns A combined filter function
+ */
+export function combineLogFilters(...filters) {
+    return (entry) => filters.every((f) => f(entry));
+}
+/**
+ * Create a log entry from raw data
+ *
+ * Factory function for creating LogEntry objects with proper defaults.
+ *
+ * @param data - Partial log entry data
+ * @returns A complete LogEntry
+ */
+export function createLogEntry(data) {
+    return {
+        timestamp: data.timestamp ?? new Date().toISOString(),
+        level: data.level ?? "info",
+        source: data.source ?? "fleet",
+        agentName: data.agentName,
+        jobId: data.jobId,
+        scheduleName: data.scheduleName,
+        message: data.message,
+        data: data.data,
+    };
+}
+/**
+ * Format a log entry as a string
+ *
+ * Creates a human-readable string representation of a log entry.
+ *
+ * @param entry - The log entry to format
+ * @param options - Formatting options
+ * @returns A formatted string
+ */
+export function formatLogEntry(entry, options) {
+    const parts = [];
+    if (options?.includeTimestamp !== false) {
+        parts.push(`[${entry.timestamp}]`);
+    }
+    parts.push(`[${entry.level.toUpperCase()}]`);
+    if (options?.includeSource !== false && entry.source) {
+        parts.push(`[${entry.source}]`);
+    }
+    if (options?.includeContext !== false) {
+        if (entry.agentName) {
+            parts.push(`[${entry.agentName}]`);
+        }
+        if (entry.jobId) {
+            parts.push(`[${entry.jobId}]`);
+        }
+    }
+    parts.push(entry.message);
+    return parts.join(" ");
+}
+//# sourceMappingURL=log-streaming.js.map