agent-tail-core 0.3.0 → 0.3.2

package/README.md

@@ -2,10 +2,12 @@
 
 CLI and shared core for [agent-tail](https://agent-tail.vercel.app/) — pipes server output and browser console logs to log files your AI coding agents can read and `grep`.
 
+> **Tip:** Install the umbrella [`agent-tail`](https://www.npmjs.com/package/agent-tail) package to get the CLI, Vite plugin, and Next.js plugin in one install: `npm install -D agent-tail`
+
 ## Quick start
 
 ```bash
-npx agent-tail-core run 'fe: npm run dev' 'api: uvicorn main:app'
+npx agent-tail run 'fe: npm run dev' 'api: uvicorn main:app'
 ```
 
 Each service gets its own log file (`fe.log`, `api.log`) plus a `combined.log` with all output interleaved. A `latest` symlink always points to the current session:

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-CzU-rrPM.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-CzU-rrPM.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) {
@@ -49,7 +50,11 @@ var LogManager = class {
 			fs.unlinkSync(latest_link);
 		} catch {}
 		const relative_target = path.relative(log_dir, session_dir);
-		fs.symlinkSync(relative_target, latest_link);
+		try {
+			fs.symlinkSync(relative_target, latest_link);
+		} catch {
+			fs.writeFileSync(latest_link, session_dir);
+		}
 	}
 	prune_sessions(log_dir) {
 		try {
@@ -66,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.
 	*/
@@ -73,8 +89,12 @@ var LogManager = class {
 		const log_dir = path.resolve(project_root, this.options.logDir);
 		const latest_link = path.join(log_dir, "latest");
 		try {
-			const real = fs.realpathSync(latest_link);
-			if (fs.statSync(real).isDirectory()) return real;
+			const stat = fs.lstatSync(latest_link);
+			let target;
+			if (stat.isSymbolicLink()) target = fs.realpathSync(latest_link);
+			else if (stat.isFile()) target = fs.readFileSync(latest_link, "utf-8").trim();
+			else throw new Error("unexpected latest type");
+			if (fs.existsSync(target) && fs.statSync(target).isDirectory()) return target;
 		} catch {}
 		const log_path = this.initialize(project_root);
 		return path.dirname(log_path);
@@ -82,8 +102,8 @@ var LogManager = class {
 	check_gitignore(project_root) {
 		const gitignore_path = path.join(project_root, ".gitignore");
 		try {
-			const lines = fs.readFileSync(gitignore_path, "utf-8").split("\n").map((l) => l.trim());
-			const log_dir = this.options.logDir;
+			const lines = fs.readFileSync(gitignore_path, "utf-8").split(/\r?\n/).map((l) => l.trim());
+			const log_dir = this.options.logDir.replace(/\\/g, "/");
 			const parts = log_dir.split("/");
 			let covered = false;
 			for (let i = 1; i <= parts.length; i++) {
@@ -171,7 +191,7 @@ function parse_service_configs(args) {
 * Write data to a log stream and optionally to combined.log with a prefix.
 */
 function write_to_logs(chunk, name, log_stream, combined_stream, excludes = []) {
-	const lines = chunk.toString().split("\n");
+	const lines = chunk.toString().split(/\r?\n/);
 	for (let i = 0; i < lines.length; i++) if (lines[i].length > 0) {
 		if (excludes.length && should_exclude(lines[i], excludes)) continue;
 		log_stream.write(lines[i] + "\n");
@@ -197,13 +217,14 @@ function cmd_wrap(project_root, name, command, options = DEFAULT_CLI_OPTIONS) {
 		combined_stream = fs.createWriteStream(combined_file, { flags: "a" });
 	}
 	console.log(`${PREFIX} ${name} → ${log_file}`);
-	const child = spawn("sh", ["-c", command.join(" ")], {
+	const child = spawn(command.join(" "), {
 		stdio: [
 			"inherit",
 			"pipe",
 			"pipe"
 		],
-		env: { ...process.env }
+		env: { ...process.env },
+		shell: true
 	});
 	child.stdout?.on("data", (chunk) => {
 		process.stdout.write(chunk);
@@ -261,16 +282,20 @@ 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 child = spawn("sh", ["-c", svc.command], {
+		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) {
-			const lines = chunk.toString().split("\n");
+			const lines = chunk.toString().split(/\r?\n/);
 			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");
@@ -307,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,8 +1,8 @@
-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-CzU-rrPM.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) {
-	return `[${entry.timestamp}] [${entry.level.toUpperCase().padEnd(7)}] ${entry.args.join(" ")}${entry.url ? ` (${entry.url})` : ""}${entry.stack ? `\n    ${entry.stack.split("\n").join("\n    ")}` : ""}\n`;
+	return `[${entry.timestamp}] [${entry.level.toUpperCase().padEnd(7)}] ${entry.args.join(" ")}${entry.url ? ` (${entry.url})` : ""}${entry.stack ? `\n    ${entry.stack.split(/\r?\n/).join("\n    ")}` : ""}\n`;
 }
 
 //#endregion
@@ -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.0",
+  "version": "0.3.2",
   "description": "Core utilities for agent-tail log capture plugins.",
   "license": "MIT",
   "repository": {