agent-tail-core 0.3.1 → 0.3.2

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-BGQ-_7t4.mjs";
 import { parseArgs } from "node:util";
 
 //#region src/cli.ts

package/dist/{commands-LpvDep8T.mjs → commands-BGQ-_7t4.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.
 	*/
@@ -276,7 +288,10 @@ function cmd_run(project_root, service_args, options = DEFAULT_CLI_OPTIONS) {
 				"pipe",
 				"pipe"
 			],
-			env: { ...process.env },
+			env: {
+				...process.env,
+				[SESSION_ENV_VAR]: session_dir
+			},
 			shell: true
 		});
 		function handle(target, chunk) {
@@ -317,4 +332,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.
@@ -92,4 +99,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-BGQ-_7t4.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.2",
   "description": "Core utilities for agent-tail log capture plugins.",
   "license": "MIT",
   "repository": {