trickle-cli 0.1.216 → 0.1.219

package/dist/commands/hints.d.ts

@@ -13,5 +13,6 @@
 export interface HintsOptions {
     values?: boolean;
     errors?: boolean;
+    show?: string;
 }
 export declare function hintsCommand(targetFile: string | undefined, opts: HintsOptions): Promise<void>;

package/dist/commands/hints.js

@@ -277,8 +277,11 @@ async function hintsCommand(targetFile, opts) {
                         const typeStr = typeToString(v.type);
                         const scope = v.funcName ? ` (in ${v.funcName})` : "";
                         const sampleStr = formatSample(v.sample);
-                        // In error mode, always show values (crash-time state)
-                        if ((opts.errors || opts.values) && v.sample !== undefined) {
+                        const nbShowMode = opts.show || (opts.errors ? "both" : (opts.values ? "both" : "types"));
+                        if (nbShowMode === "values" && v.sample !== undefined) {
+                            console.log(`${v.varName} = ${sampleStr}${scope}`);
+                        }
+                        else if (nbShowMode === "both" && v.sample !== undefined) {
                             console.log(`${v.varName}: ${typeStr} = ${sampleStr}${scope}`);
                         }
                         else {
@@ -322,6 +325,12 @@ async function hintsCommand(targetFile, opts) {
             const obs = lineObs.get(lineNo);
             if (!obs || obs.size === 0) {
                 console.log(src);
+                // Show error underline on the error line
+                if (opts.errors && errLine && lineNo === errLine) {
+                    const indent = src.match(/^(\s*)/)?.[1] || "";
+                    const contentLen = src.trimEnd().length - indent.length;
+                    console.log(indent + "~".repeat(Math.max(contentLen, 1)) + `  ← ${errMsg}`);
+                }
                 continue;
             }
             // Insert type hints inline after variable names
@@ -365,9 +374,14 @@ async function hintsCommand(targetFile, opts) {
                     if (isFuncParam && afterVar.startsWith(":"))
                         continue;
                 }
-                // Build the hint string — error mode always shows values (crash-time state)
+                // Build the hint string based on --show mode
+                const showMode = opts.show || (opts.errors ? "both" : (opts.values ? "both" : "types"));
+                const hasSample = v.sample !== undefined && v.sample !== null;
                 let hint;
-                if ((opts.errors || opts.values) && v.sample !== undefined && v.sample !== null) {
+                if (showMode === "values" && hasSample) {
+                    hint = ` = ${formatSample(v.sample)}`;
+                }
+                else if (showMode === "both" && hasSample) {
                     const sampleStr = formatSample(v.sample);
                     hint = sampleStr ? `: ${typeStr} = ${sampleStr}` : `: ${typeStr}`;
                 }
@@ -378,6 +392,12 @@ async function hintsCommand(targetFile, opts) {
                 annotated = annotated.substring(0, varEnd) + hint + annotated.substring(varEnd);
             }
             console.log(annotated);
+            // Show error underline on the error line
+            if (opts.errors && errLine && lineNo === errLine) {
+                const indent = src.match(/^(\s*)/)?.[1] || "";
+                const contentLen = src.trimEnd().length - indent.length;
+                console.log(indent + "~".repeat(Math.max(contentLen, 1)) + `  ← ${errMsg}`);
+            }
         }
         console.log("```");
         console.log("");

package/dist/index.js

@@ -540,6 +540,7 @@ program
     .description("Output source code with inline type hints from runtime observations (for AI agents)")
     .option("--values", "Include sample values alongside types")
     .option("--errors", "Show error mode — variables at crash time with values that caused the error")
+    .option("--show <mode>", "What to show inline: types, values, or both (default: both in error mode, types otherwise)")
     .action(async (file, opts) => {
     await (0, hints_1.hintsCommand)(file, opts);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trickle-cli",
-  "version": "0.1.216",
+  "version": "0.1.219",
   "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/hints.ts

@@ -17,6 +17,7 @@ import * as path from "path";
 export interface HintsOptions {
   values?: boolean;
   errors?: boolean;
+  show?: string; // "types", "values", "both" (default: "both" in error mode, "types" otherwise)
 }
 
 interface TypeNode {
@@ -268,8 +269,10 @@ export async function hintsCommand(
             const typeStr = typeToString(v.type);
             const scope = v.funcName ? ` (in ${v.funcName})` : "";
             const sampleStr = formatSample(v.sample);
-            // In error mode, always show values (crash-time state)
-            if ((opts.errors || opts.values) && v.sample !== undefined) {
+            const nbShowMode = opts.show || (opts.errors ? "both" : (opts.values ? "both" : "types"));
+            if (nbShowMode === "values" && v.sample !== undefined) {
+              console.log(`${v.varName} = ${sampleStr}${scope}`);
+            } else if (nbShowMode === "both" && v.sample !== undefined) {
               console.log(`${v.varName}: ${typeStr} = ${sampleStr}${scope}`);
             } else {
               console.log(`${v.varName}: ${typeStr}${scope}`);
@@ -312,6 +315,12 @@ export async function hintsCommand(
 
       if (!obs || obs.size === 0) {
         console.log(src);
+        // Show error underline on the error line
+        if (opts.errors && errLine && lineNo === errLine) {
+          const indent = src.match(/^(\s*)/)?.[1] || "";
+          const contentLen = src.trimEnd().length - indent.length;
+          console.log(indent + "~".repeat(Math.max(contentLen, 1)) + `  ← ${errMsg}`);
+        }
         continue;
       }
 
@@ -357,9 +366,13 @@ export async function hintsCommand(
           if (isFuncParam && afterVar.startsWith(":")) continue;
         }
 
-        // Build the hint string — error mode always shows values (crash-time state)
+        // Build the hint string based on --show mode
+        const showMode = opts.show || (opts.errors ? "both" : (opts.values ? "both" : "types"));
+        const hasSample = v.sample !== undefined && v.sample !== null;
         let hint: string;
-        if ((opts.errors || opts.values) && v.sample !== undefined && v.sample !== null) {
+        if (showMode === "values" && hasSample) {
+          hint = ` = ${formatSample(v.sample)}`;
+        } else if (showMode === "both" && hasSample) {
           const sampleStr = formatSample(v.sample);
           hint = sampleStr ? `: ${typeStr} = ${sampleStr}` : `: ${typeStr}`;
         } else {
@@ -371,6 +384,12 @@ export async function hintsCommand(
       }
 
       console.log(annotated);
+      // Show error underline on the error line
+      if (opts.errors && errLine && lineNo === errLine) {
+        const indent = src.match(/^(\s*)/)?.[1] || "";
+        const contentLen = src.trimEnd().length - indent.length;
+        console.log(indent + "~".repeat(Math.max(contentLen, 1)) + `  ← ${errMsg}`);
+      }
     }
 
     console.log("```");

package/src/index.ts

@@ -541,7 +541,8 @@ program
   .description("Output source code with inline type hints from runtime observations (for AI agents)")
   .option("--values", "Include sample values alongside types")
   .option("--errors", "Show error mode — variables at crash time with values that caused the error")
-  .action(async (file: string | undefined, opts: { values?: boolean; errors?: boolean }) => {
+  .option("--show <mode>", "What to show inline: types, values, or both (default: both in error mode, types otherwise)")
+  .action(async (file: string | undefined, opts: { values?: boolean; errors?: boolean; show?: string }) => {
     await hintsCommand(file, opts);
   });