agent-tail-core 0.3.1 → 0.3.3

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as cmd_run, r as cmd_wrap, t as cmd_init } from "./commands-LpvDep8T.mjs";
+import { n as cmd_run, r as cmd_wrap, t as cmd_init } from "./commands-B32lAAvI.mjs";
 import { parseArgs } from "node:util";
 
 //#region src/cli.ts
@@ -16,6 +16,7 @@ const HELP = `
     --max-sessions <n>    Max sessions to keep (default: 10)
     --no-combined         Don't write to combined.log
     --exclude <pattern>   Exclude lines matching pattern (repeatable, /regex or substring)
+    --mute <name>         Mute a service from terminal and combined.log (repeatable, still logs to <name>.log)
     -h, --help            Show this help
 
   \x1b[1mExamples:\x1b[0m
@@ -47,6 +48,10 @@ function parse_cli_options(args) {
 				type: "string",
 				multiple: true
 			},
+			mute: {
+				type: "string",
+				multiple: true
+			},
 			help: {
 				type: "boolean",
 				short: "h",
@@ -65,7 +70,8 @@ function parse_cli_options(args) {
 			log_dir: values["log-dir"] ?? "tmp/logs",
 			max_sessions: parseInt(values["max-sessions"] ?? "10", 10),
 			combined: !values["no-combined"],
-			excludes: values.exclude ?? []
+			excludes: values.exclude ?? [],
+			mutes: values.mute ?? []
 		},
 		positionals,
 		rest

package/dist/{commands-LpvDep8T.mjs → commands-B32lAAvI.mjs}

@@ -17,6 +17,7 @@ function should_exclude(message, excludes) {
 //#endregion
 //#region src/log-manager.ts
 const PLUGIN_PREFIX = "\x1B[36m[agent-tail]\x1B[0m";
+const SESSION_ENV_VAR = "AGENT_TAIL_SESSION";
 let session_counter = 0;
 var LogManager = class {
 	constructor(options) {
@@ -70,6 +71,17 @@ var LogManager = class {
 		} catch {}
 	}
 	/**
+	* Join an existing session directory. Creates the log file if it doesn't
+	* exist. Use this when a parent process (e.g. `agent-tail run`) has
+	* already created the session and passed its path via AGENT_TAIL_SESSION.
+	*/
+	join_session(session_dir) {
+		const log_file = path.join(session_dir, this.options.logFileName);
+		if (!fs.existsSync(log_file)) fs.writeFileSync(log_file, "");
+		console.log(`${PLUGIN_PREFIX} Writing to ${log_file}`);
+		return log_file;
+	}
+	/**
 	* Resolve the current session directory. If a `latest` symlink exists and
 	* points to a valid directory, return it. Otherwise create a new session.
 	*/
@@ -144,7 +156,8 @@ const DEFAULT_CLI_OPTIONS = {
 	log_dir: "tmp/logs",
 	max_sessions: 10,
 	combined: true,
-	excludes: []
+	excludes: [],
+	mutes: []
 };
 function create_manager(options) {
 	return new LogManager(resolve_options({
@@ -270,13 +283,17 @@ function cmd_run(project_root, service_args, options = DEFAULT_CLI_OPTIONS) {
 		const tag = `${COLORS[i % COLORS.length]}[${svc.name}]${RESET}`;
 		const log_file = path.join(session_dir, `${svc.name}.log`);
 		const log_stream = fs.createWriteStream(log_file, { flags: "a" });
+		const is_muted = options.mutes.includes(svc.name);
 		const child = spawn(svc.command, {
 			stdio: [
 				"inherit",
 				"pipe",
 				"pipe"
 			],
-			env: { ...process.env },
+			env: {
+				...process.env,
+				[SESSION_ENV_VAR]: session_dir
+			},
 			shell: true
 		});
 		function handle(target, chunk) {
@@ -284,12 +301,16 @@ function cmd_run(project_root, service_args, options = DEFAULT_CLI_OPTIONS) {
 			for (let j = 0; j < lines.length; j++) if (lines[j].length > 0) {
 				if (options.excludes.length && should_exclude(lines[j], options.excludes)) continue;
 				log_stream.write(lines[j] + "\n");
-				target.write(`${tag} ${lines[j]}\n`);
-				combined_stream?.write(`[${svc.name}] ${lines[j]}\n`);
+				if (!is_muted) {
+					target.write(`${tag} ${lines[j]}\n`);
+					combined_stream?.write(`[${svc.name}] ${lines[j]}\n`);
+				}
 			} else if (j < lines.length - 1) {
 				log_stream.write("\n");
-				target.write("\n");
-				combined_stream?.write("\n");
+				if (!is_muted) {
+					target.write("\n");
+					combined_stream?.write("\n");
+				}
 			}
 		}
 		child.stdout?.on("data", (chunk) => handle(process.stdout, chunk));
@@ -317,4 +338,4 @@ function cmd_run(project_root, service_args, options = DEFAULT_CLI_OPTIONS) {
 }
 
 //#endregion
-export { resolve_session_dir as a, LogManager as c, parse_service_configs as i, should_exclude as l, cmd_run as n, DEFAULT_OPTIONS as o, cmd_wrap as r, resolve_options as s, cmd_init as t };
+export { resolve_session_dir as a, LogManager as c, parse_service_configs as i, SESSION_ENV_VAR as l, cmd_run as n, DEFAULT_OPTIONS as o, cmd_wrap as r, resolve_options as s, cmd_init as t, should_exclude as u };

package/dist/index.d.mts

@@ -46,6 +46,7 @@ declare function should_exclude(message: string, excludes: string[]): boolean;
 declare function generate_client_script(options: ResolvedOptions): string;
 //#endregion
 //#region src/log-manager.d.ts
+declare const SESSION_ENV_VAR = "AGENT_TAIL_SESSION";
 declare class LogManager {
   private options;
   constructor(options: ResolvedOptions);
@@ -53,6 +54,12 @@ declare class LogManager {
   create_session_name(): string;
   update_latest_symlink(log_dir: string, session_dir: string): void;
   prune_sessions(log_dir: string): void;
+  /**
+   * Join an existing session directory. Creates the log file if it doesn't
+   * exist. Use this when a parent process (e.g. `agent-tail run`) has
+   * already created the session and passed its path via AGENT_TAIL_SESSION.
+   */
+  join_session(session_dir: string): string;
   /**
    * Resolve the current session directory. If a `latest` symlink exists and
    * points to a valid directory, return it. Otherwise create a new session.
@@ -67,6 +74,7 @@ interface CliOptions {
   max_sessions: number;
   combined: boolean;
   excludes: string[];
+  mutes: string[];
 }
 /**
  * Create a new log session. Returns the session directory path.
@@ -92,4 +100,4 @@ declare function cmd_wrap(project_root: string, name: string, command: string[],
  */
 declare function cmd_run(project_root: string, service_args: string[], options?: CliOptions): Promise<void>;
 //#endregion
-export { type BrowserLogsOptions, type CliOptions, DEFAULT_OPTIONS, type LogEntry, LogManager, type ResolvedOptions, type ServiceConfig, cmd_init, cmd_run, cmd_wrap, format_log_line, generate_client_script, parse_service_configs, resolve_options, resolve_session_dir, should_exclude };
+export { type BrowserLogsOptions, type CliOptions, DEFAULT_OPTIONS, type LogEntry, LogManager, type ResolvedOptions, SESSION_ENV_VAR, type ServiceConfig, cmd_init, cmd_run, cmd_wrap, format_log_line, generate_client_script, parse_service_configs, resolve_options, resolve_session_dir, should_exclude };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as resolve_session_dir, c as LogManager, i as parse_service_configs, l as should_exclude, n as cmd_run, o as DEFAULT_OPTIONS, r as cmd_wrap, s as resolve_options, t as cmd_init } from "./commands-LpvDep8T.mjs";
+import { a as resolve_session_dir, c as LogManager, i as parse_service_configs, l as SESSION_ENV_VAR, n as cmd_run, o as DEFAULT_OPTIONS, r as cmd_wrap, s as resolve_options, t as cmd_init, u as should_exclude } from "./commands-B32lAAvI.mjs";
 
 //#region src/formatter.ts
 function format_log_line(entry) {
@@ -121,4 +121,4 @@ function generate_client_script(options) {
 }
 
 //#endregion
-export { DEFAULT_OPTIONS, LogManager, cmd_init, cmd_run, cmd_wrap, format_log_line, generate_client_script, parse_service_configs, resolve_options, resolve_session_dir, should_exclude };
+export { DEFAULT_OPTIONS, LogManager, SESSION_ENV_VAR, cmd_init, cmd_run, cmd_wrap, format_log_line, generate_client_script, parse_service_configs, resolve_options, resolve_session_dir, should_exclude };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-tail-core",
   "type": "module",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Core utilities for agent-tail log capture plugins.",
   "license": "MIT",
   "repository": {