@ramarivera/coding-agent-langfuse 0.1.33 → 0.1.35

package/README.md

@@ -77,6 +77,12 @@ The Windows path intentionally uses a per-user Scheduled Task for the default
 `npx` workflow. A true Windows SCM service needs an installed wrapper or native
 service binary; raw `sc.exe` is not a good fit for a transient npm command.
 
+The generated services are package-manager agnostic. By default the installer
+uses `npx` through the service `PATH` (`/usr/bin/env npx` on macOS and Linux)
+and captures the current `PATH`; use `--npx-path` and `--path` when installing
+from a shell manager such as Homebrew, nvm, fnm, Volta, asdf, mise, or a system
+Node.js install.
+
 ## Backfill windows
 
 Backfill only a timeframe when repairing a host or replaying a recent window:

package/dist/service.d.ts

@@ -13,6 +13,7 @@ type ServiceOptions = {
     batchSize: number;
     pollIntervalMs: number;
     postDelayMs: number;
+    npxPath: string;
     since?: string;
     dryRun: boolean;
     start: boolean;

package/dist/service.js

@@ -20,6 +20,7 @@ Service options:
   --state PATH            Dedupe state file
   --home PATH             Home directory to scan (default: current user home)
   --package-spec SPEC     npx package spec (default: ${defaultPackageSpec})
+  --npx-path PATH         npx executable path for host services (default: auto-detected)
   --batch-size N          OTLP spans per POST (default: 10)
   --poll-interval-ms N    Delay between --follow scans (default: 5000)
   --post-delay-ms N       Delay after each successful OTLP POST (default: 0)
@@ -44,6 +45,7 @@ function parseServiceArgs(argv) {
     let statePath = "";
     let name = "";
     let packageSpec = defaultPackageSpec;
+    let npxPath = process.env.CODING_AGENT_LANGFUSE_NPX_PATH ?? "";
     let batchSize = 10;
     let pollIntervalMs = 5_000;
     let postDelayMs = 0;
@@ -81,6 +83,9 @@ function parseServiceArgs(argv) {
         else if (arg === "--package-spec") {
             packageSpec = next();
         }
+        else if (arg === "--npx-path") {
+            npxPath = next();
+        }
         else if (arg === "--batch-size") {
             batchSize = parsePositiveInt(arg, next());
         }
@@ -114,6 +119,7 @@ function parseServiceArgs(argv) {
     name ||= defaultServiceName(agents, platform);
     workingDirectory ||= homeDir;
     pathEnv ||= defaultPathEnv(homeDir, platform);
+    npxPath ||= defaultNpxPath(platform);
     statePath ||= join(homeDir, ".local/state/coding-agent-langfuse", `${name}.json`);
     return {
         action,
@@ -124,6 +130,7 @@ function parseServiceArgs(argv) {
         homeDir,
         name,
         packageSpec,
+        npxPath,
         batchSize,
         pollIntervalMs,
         postDelayMs,
@@ -254,7 +261,7 @@ async function serviceMain(argv = process.argv.slice(2)) {
 }
 function buildFollowCommand(options) {
     const command = [
-        options.platform === "win32" ? "npx.cmd" : "npx",
+        options.npxPath,
         "--yes",
         options.packageSpec,
         "--agents",
@@ -299,6 +306,7 @@ WantedBy=default.target
 `;
 }
 function renderLaunchdPlist(options, command) {
+    const programArguments = launchdCommand(command);
     return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -307,7 +315,7 @@ function renderLaunchdPlist(options, command) {
   <string>${escapeXml(options.name)}</string>
   <key>ProgramArguments</key>
   <array>
-${command.map((part) => `    <string>${escapeXml(part)}</string>`).join("\n")}
+${programArguments.map((part) => `    <string>${escapeXml(part)}</string>`).join("\n")}
   </array>
   <key>EnvironmentVariables</key>
   <dict>
@@ -376,6 +384,8 @@ function defaultServiceName(agents, platform) {
         : `coding-agent-langfuse-${suffix}`;
 }
 function defaultPathEnv(homeDir, platform) {
+    if (process.env.PATH)
+        return process.env.PATH;
     if (platform === "win32") {
         return [
             "%APPDATA%\\npm",
@@ -385,7 +395,6 @@ function defaultPathEnv(homeDir, platform) {
         ].join(";");
     }
     return [
-        join(homeDir, ".local/share/mise/shims"),
         join(homeDir, ".local/bin"),
         "/opt/homebrew/bin",
         "/usr/local/bin",
@@ -395,6 +404,30 @@ function defaultPathEnv(homeDir, platform) {
         "/sbin",
     ].join(":");
 }
+function defaultNpxPath(platform) {
+    if (platform === "win32") {
+        return findExecutable("npx.cmd", "where") ?? "npx.cmd";
+    }
+    return "npx";
+}
+function launchdCommand(command) {
+    const [program, ...args] = command;
+    if (!program)
+        return command;
+    return program.includes("/") ? command : ["/usr/bin/env", program, ...args];
+}
+function findExecutable(name, finder) {
+    try {
+        const output = execFileSync(finder, [name], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        return output.split(/\r?\n/).find((line) => line.trim().length > 0)?.trim();
+    }
+    catch {
+        return undefined;
+    }
+}
 function parsePositiveInt(flag, value) {
     const parsed = Number.parseInt(value, 10);
     if (!Number.isFinite(parsed) || parsed < 1) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ramarivera/coding-agent-langfuse",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "description": "Universal coding-agent Langfuse backfiller and live OTLP helpers",
   "type": "module",
   "license": "MIT",