trickle-cli 0.1.224 → 0.1.226

package/dist/commands/run.js

@@ -39,6 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runCommand = runCommand;
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
 const child_process_1 = require("child_process");
 const chalk_1 = __importDefault(require("chalk"));
 const config_1 = require("../config");
@@ -1219,6 +1220,9 @@ function injectObservation(command, backendUrl, opts) {
         // Auto-enable terminal type summary when running via trickle run
         if (!process.env.TRICKLE_SUMMARY)
             env.TRICKLE_SUMMARY = "1";
+        // Ensure trickle is importable even if the target Python is a venv without it.
+        // Find trickle's install location from any available system Python and inject via PYTHONPATH.
+        ensureTricklePythonPath(python, env);
         return {
             instrumentedCommand: `${python} -c "from trickle.observe_runner import main; main()" ${rest}`,
             env,
@@ -1229,6 +1233,7 @@ function injectObservation(command, backendUrl, opts) {
             env.TRICKLE_OBSERVE_INCLUDE = opts.include;
         if (opts.exclude)
             env.TRICKLE_OBSERVE_EXCLUDE = opts.exclude;
+        ensureTricklePythonPath("python", env);
         return {
             instrumentedCommand: `python -c "from trickle.observe_runner import main; main()" -m ${command}`,
             env,
@@ -1239,6 +1244,43 @@ function injectObservation(command, backendUrl, opts) {
     env.NODE_OPTIONS = `${existing} -r ${observePath}`.trim();
     return { instrumentedCommand: command, env };
 }
+/**
+ * Ensure the target Python can import trickle by creating an isolated temp
+ * directory with a symlink to just the trickle package and adding it to PYTHONPATH.
+ * This avoids polluting the target Python with the entire system site-packages,
+ * which would cause binary incompatibilities across Python versions.
+ */
+function ensureTricklePythonPath(targetPython, env) {
+    // First check if the target Python already has trickle
+    try {
+        (0, child_process_1.execSync)(`${targetPython} -c "import trickle" 2>/dev/null`, { stdio: "ignore", timeout: 5000 });
+        return; // trickle is already importable
+    }
+    catch {
+        // Not available in target Python — find it elsewhere
+    }
+    // Try common Python commands to find where trickle is installed
+    const candidates = ["python3", "python", "python3.11", "python3.12", "python3.13", "python3.10"];
+    for (const py of candidates) {
+        try {
+            // Get the trickle package directory (e.g. /opt/anaconda3/.../site-packages/trickle)
+            const trickleDir = (0, child_process_1.execSync)(`${py} -c "import trickle, os; print(os.path.dirname(trickle.__file__))"`, { encoding: "utf-8", timeout: 5000, stdio: ["ignore", "pipe", "ignore"] }).trim();
+            if (trickleDir && fs.existsSync(trickleDir)) {
+                // Create a temp directory with just a symlink to the trickle package.
+                // This ensures only trickle (pure Python) is visible, not incompatible
+                // binary packages from a different Python version's site-packages.
+                const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "trickle-pypath-"));
+                fs.symlinkSync(trickleDir, path.join(tmpDir, "trickle"));
+                const existing = env.PYTHONPATH || process.env.PYTHONPATH || "";
+                env.PYTHONPATH = existing ? `${tmpDir}:${existing}` : tmpDir;
+                return;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+}
 function resolveObservePath() {
     try {
         return require.resolve("trickle-observe/observe");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trickle-cli",
-  "version": "0.1.224",
+  "version": "0.1.226",
   "description": "Zero-code runtime observability for JS/Python + AI agent debugging. Traces LangChain, CrewAI, OpenAI, Anthropic, Gemini. Eval, security, compliance, cost tracking. Free, local-first.",
   "keywords": [
     "observability",

package/src/commands/run.ts

@@ -1,6 +1,7 @@
 import * as path from "path";
 import * as fs from "fs";
-import { spawn, ChildProcess } from "child_process";
+import * as os from "os";
+import { spawn, execSync, ChildProcess } from "child_process";
 import chalk from "chalk";
 import { getBackendUrl } from "../config";
 import {
@@ -1336,6 +1337,9 @@ function injectObservation(
     if (opts.exclude) env.TRICKLE_OBSERVE_EXCLUDE = opts.exclude;
     // Auto-enable terminal type summary when running via trickle run
     if (!process.env.TRICKLE_SUMMARY) env.TRICKLE_SUMMARY = "1";
+    // Ensure trickle is importable even if the target Python is a venv without it.
+    // Find trickle's install location from any available system Python and inject via PYTHONPATH.
+    ensureTricklePythonPath(python, env);
     return {
       instrumentedCommand: `${python} -c "from trickle.observe_runner import main; main()" ${rest}`,
       env,
@@ -1345,6 +1349,7 @@ function injectObservation(
   if (/^(pytest|uvicorn|gunicorn|flask|django-admin)\b/.test(command)) {
     if (opts.include) env.TRICKLE_OBSERVE_INCLUDE = opts.include;
     if (opts.exclude) env.TRICKLE_OBSERVE_EXCLUDE = opts.exclude;
+    ensureTricklePythonPath("python", env);
     return {
       instrumentedCommand: `python -c "from trickle.observe_runner import main; main()" -m ${command}`,
       env,
@@ -1361,6 +1366,52 @@ function injectObservation(
   return { instrumentedCommand: command, env };
 }
 
+/**
+ * Ensure the target Python can import trickle by creating an isolated temp
+ * directory with a symlink to just the trickle package and adding it to PYTHONPATH.
+ * This avoids polluting the target Python with the entire system site-packages,
+ * which would cause binary incompatibilities across Python versions.
+ */
+function ensureTricklePythonPath(
+  targetPython: string,
+  env: Record<string, string>,
+): void {
+  // First check if the target Python already has trickle
+  try {
+    execSync(
+      `${targetPython} -c "import trickle" 2>/dev/null`,
+      { stdio: "ignore", timeout: 5000 },
+    );
+    return; // trickle is already importable
+  } catch {
+    // Not available in target Python — find it elsewhere
+  }
+
+  // Try common Python commands to find where trickle is installed
+  const candidates = ["python3", "python", "python3.11", "python3.12", "python3.13", "python3.10"];
+  for (const py of candidates) {
+    try {
+      // Get the trickle package directory (e.g. /opt/anaconda3/.../site-packages/trickle)
+      const trickleDir = execSync(
+        `${py} -c "import trickle, os; print(os.path.dirname(trickle.__file__))"`,
+        { encoding: "utf-8", timeout: 5000, stdio: ["ignore", "pipe", "ignore"] },
+      ).trim();
+      if (trickleDir && fs.existsSync(trickleDir)) {
+        // Create a temp directory with just a symlink to the trickle package.
+        // This ensures only trickle (pure Python) is visible, not incompatible
+        // binary packages from a different Python version's site-packages.
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "trickle-pypath-"));
+        fs.symlinkSync(trickleDir, path.join(tmpDir, "trickle"));
+        const existing = env.PYTHONPATH || process.env.PYTHONPATH || "";
+        env.PYTHONPATH = existing ? `${tmpDir}:${existing}` : tmpDir;
+        return;
+      }
+    } catch {
+      continue;
+    }
+  }
+}
+
 function resolveObservePath(): string {
   try {
     return require.resolve("trickle-observe/observe");