@webywz/agent-trace 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 webywz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,153 @@
-# Temporary Holding Version
+# agent-trace
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Turn messy agent run logs into a readable timeline.
+
+OpenAI tool-call dumps, LangChain / LangSmith trees, JSONL event streams, Cursor-ish traces — all of them are painful to skim. `agent-trace` is an offline CLI that normalizes those shapes into a numbered timeline: thoughts, tools, results, errors, durations, and a one-line autopsy.
+
+No API key. No network. Pipe a dump, get a story.
+
+## 30-second demo
+
+Copy-paste. `--demo` is bundled with the package, so this works without cloning the repo.
+
+```bash
+npx @webywz/agent-trace --demo --no-color
+```
+
+```text
+$ npx @webywz/agent-trace --demo --stats --no-color
+19 steps · 7 tool calls · 1 failure · ~1,840 in / 96 out · 15.3s
+
+$ npx @webywz/agent-trace --demo --no-color
+agent-trace  ·  examples/run.jsonl
+jsonl  ·  19 steps  ·  7 tool calls  ·  1 failure  ·  15.3s
+────────────────────────────────────────────────────────────────────────
+  1  user          +0ms  770ms
+     │  The login test is flaky on CI. Fix it. Do not sleep() your way …
+     │
+  3  tool        +890ms  170ms  read_file
+     │  {"path":"test/login.spec.ts"}
+     │
+ 12  tool        +2.68s  6.61s  run_tests
+     │  {"cmd":"npx playwright test test/login.spec.ts --repeat-each=8"}
+     │
+ 13  error       +9.29s  470ms  run_tests
+     │  1 failed · login.spec.ts:12: cookie sid missing on first naviga…
+     │
+ 19  assistant   +15.3s
+     │  The flake was a cookie/redirect race, not a slow page. Cookie i…
+────────────────────────────────────────────────────────────────────────
+  19 steps · 7 tool calls · 1 failure · ~1,840 in / 96 out · 15.3s
+```
+
+The sample above is abbreviated; the real command prints all 19 steps. `--demo` is the bundled `examples/run.jsonl` (a coding agent that fails `run_tests` once, then recovers).
+
+```bash
+npx @webywz/agent-trace --demo --spicy --no-color
+# spicy  The brief was “The login test is flaky…”. Then `run_tests` blew up: …
+```
+
+## Install
+
+```bash
+npm i -g @webywz/agent-trace
+agent-trace --demo
+```
+
+Node 18+. No API key required.
+
+```bash
+npx @webywz/agent-trace --demo
+cat run.jsonl | npx @webywz/agent-trace
+```
+
+## Usage
+
+```bash
+agent-trace --demo
+agent-trace run.jsonl
+agent-trace --format auto|openai|langchain|jsonl|generic run.jsonl
+agent-trace --json run.jsonl | jq .stats
+agent-trace --stats run.jsonl
+agent-trace --fail-on-error --stats traces/ci.jsonl
+agent-trace --spicy run.jsonl
+cat run.jsonl | agent-trace
+```
+
+| Flag | What it does |
+| --- | --- |
+| `-f, --format` | `auto` (default), `openai`, `langchain`, `jsonl`, `generic` |
+| `-j, --json` | Normalized trace as JSON (steps, stats, warnings) |
+| `--stats` | One-line summary only (good for CI logs) |
+| `--spicy` | A short narrative recap. Offline by default; uses `OPENAI_API_KEY` or `ANTHROPIC_API_KEY` when set |
+| `--fail-on-error` | Exit `1` if the run had tool/step failures |
+| `--demo` | Render the bundled sample (`examples/run.jsonl`) |
+| `--ascii` | ASCII-only timeline (no box drawing) |
+| `--color` / `--no-color` | Force or disable ANSI colors (`NO_COLOR` also disables) |
+| `--width <n>` | Wrap width (defaults to the terminal) |
+| `--max-content <n>` | Truncate args / results (default 160) |
+
+`--spicy` never blocks the timeline. If the key is missing, the recap is local. If the LLM call fails, you still get the local recap.
+
+### Exit codes
+
+| Code | When |
+| --- | --- |
+| `0` | Timeline (or JSON / stats) printed |
+| `1` | I/O or parse error, **or** `--fail-on-error` when the trace has failures |
+| `2` | Usage error (unknown flag, missing file). stderr ends with `try 'agent-trace --help'` |
+
+CI one-liner — fail the job if the agent run had failures:
+
+```bash
+agent-trace --fail-on-error --stats traces/last-run.jsonl
+```
+
+## What it parses
+
+**OpenAI** — `chat.completion` objects, `messages[]` with `tool_calls` / `role: tool`, Responses API `output[]`, and streamed JSONL chunks with `delta`.
+
+**LangChain** — LangSmith run trees (`run_type` + `child_runs`), callback events (`on_tool_start`, `on_tool_end`, `on_chain_error`, …), `AgentAction` dumps.
+
+**JSONL** — one event per line: `role` / `type` / `tool` / `content` / `ts`. Cursor-ish traces included. Bad lines are skipped and reported.
+
+**Generic** — a JSON array (or `{ events: [...] }`) of `{ type, name, content, ts }`.
+
+Auto-detect sniffs the file; `--format` forces a parser.
+
+## Library
+
+```ts
+import { parseTrace, renderTimeline, spicyNarrative } from "@webywz/agent-trace";
+import { readFile } from "node:fs/promises";
+
+const text = await readFile("run.jsonl", "utf8");
+const trace = parseTrace(text, { format: "auto", source: "run.jsonl" });
+process.stdout.write(renderTimeline(trace, { color: false }));
+```
+
+`Trace.stats` always includes step / tool / failure counts, plus duration and token in/out when the log carries timestamps or usage.
+
+## Examples
+
+Same repo, ready to paste. Walkthrough: [`examples/README.md`](examples/README.md).
+
+```bash
+agent-trace --demo
+agent-trace examples/run.jsonl
+agent-trace examples/openai.json
+agent-trace examples/langchain.json
+agent-trace --json examples/generic.json
+agent-trace --fail-on-error --stats examples/run.jsonl; echo $?
+```
+
+## Develop
+
+```bash
+npm install
+npm test
+npm run build
+node dist/cli.js --demo --no-color
+```
+
+MIT © webywz

package/dist/args.d.ts

@@ -0,0 +1,23 @@
+import type { TraceFormat } from "./types.js";
+export interface CliArgs {
+    file?: string;
+    format: TraceFormat;
+    json: boolean;
+    spicy: boolean;
+    color?: boolean;
+    ascii: boolean;
+    width?: number;
+    maxContent?: number;
+    help: boolean;
+    version: boolean;
+    demo: boolean;
+    failOnError: boolean;
+    stats: boolean;
+}
+export declare class UsageError extends Error {
+    readonly exitCode = 2;
+    constructor(message: string);
+}
+export declare function parseArgs(argv: string[]): CliArgs;
+export declare function helpText(version: string): string;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,QAAQ,KAAK;gBACV,OAAO,EAAE,MAAM;CAI5B;AAyBD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAyGjD;AA8CD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA6ChD"}

package/dist/args.js

@@ -0,0 +1,216 @@
+export class UsageError extends Error {
+    exitCode = 2;
+    constructor(message) {
+        super(message);
+        this.name = "UsageError";
+    }
+}
+const FORMATS = new Set(["auto", "openai", "langchain", "jsonl", "generic"]);
+const FORMAT_LIST = "auto|openai|langchain|jsonl|generic";
+const FLAGS = [
+    "-h",
+    "--help",
+    "-v",
+    "--version",
+    "--json",
+    "-j",
+    "--spicy",
+    "--ascii",
+    "--no-color",
+    "--color",
+    "-f",
+    "--format",
+    "--width",
+    "--max-content",
+    "--demo",
+    "--fail-on-error",
+    "--stats",
+];
+export function parseArgs(argv) {
+    const args = {
+        format: "auto",
+        json: false,
+        spicy: false,
+        ascii: false,
+        help: false,
+        version: false,
+        demo: false,
+        failOnError: false,
+        stats: false,
+    };
+    const rest = argv.slice(2);
+    for (let i = 0; i < rest.length; i += 1) {
+        const token = rest[i];
+        if (!token)
+            continue;
+        if (token === "--") {
+            const file = rest[i + 1];
+            if (file)
+                args.file = file;
+            break;
+        }
+        if (token === "-") {
+            if (args.file)
+                throw new UsageError("unexpected extra argument '-'");
+            args.file = "-";
+            continue;
+        }
+        if (token === "-h" || token === "--help") {
+            args.help = true;
+            continue;
+        }
+        if (token === "-v" || token === "--version") {
+            args.version = true;
+            continue;
+        }
+        if (token === "--json" || token === "-j") {
+            args.json = true;
+            continue;
+        }
+        if (token === "--spicy") {
+            args.spicy = true;
+            continue;
+        }
+        if (token === "--ascii") {
+            args.ascii = true;
+            continue;
+        }
+        if (token === "--no-color") {
+            args.color = false;
+            continue;
+        }
+        if (token === "--color") {
+            args.color = true;
+            continue;
+        }
+        if (token === "--demo") {
+            args.demo = true;
+            continue;
+        }
+        if (token === "--fail-on-error") {
+            args.failOnError = true;
+            continue;
+        }
+        if (token === "--stats") {
+            args.stats = true;
+            continue;
+        }
+        const eq = token.indexOf("=");
+        const [flag, inline] = eq === -1 ? [token, undefined] : [token.slice(0, eq), token.slice(eq + 1)];
+        if (flag === "-f" || flag === "--format") {
+            const value = inline ?? rest[++i];
+            if (!value || value.startsWith("-") || !FORMATS.has(value)) {
+                throw new UsageError(`unknown format '${value ?? ""}' (expected ${FORMAT_LIST})`);
+            }
+            args.format = value;
+            continue;
+        }
+        if (flag === "--width") {
+            args.width = toInt(inline ?? rest[++i], "--width");
+            continue;
+        }
+        if (flag === "--max-content") {
+            args.maxContent = toInt(inline ?? rest[++i], "--max-content");
+            continue;
+        }
+        if (token.startsWith("-")) {
+            const hint = suggestFlag(token);
+            throw new UsageError(hint ? `unknown option '${token}' (did you mean ${hint}?)` : `unknown option '${token}'`);
+        }
+        if (args.file) {
+            throw new UsageError(`unexpected extra argument '${token}'`);
+        }
+        args.file = token;
+    }
+    if (args.demo && args.file) {
+        throw new UsageError("do not pass a file with --demo (the bundled sample is used)");
+    }
+    return args;
+}
+function toInt(value, flag) {
+    const n = Number(value);
+    if (!value || value.startsWith("-") || !Number.isInteger(n) || n <= 0) {
+        throw new UsageError(`${flag} expects a positive integer`);
+    }
+    return n;
+}
+function suggestFlag(token) {
+    if (token.startsWith("--") && token.length >= 4) {
+        const prefixes = FLAGS.filter((flag) => flag.startsWith(token));
+        if (prefixes.length === 1)
+            return prefixes[0];
+    }
+    let best;
+    let bestDist = 3;
+    for (const flag of FLAGS) {
+        const dist = levenshtein(token, flag);
+        if (dist < bestDist) {
+            bestDist = dist;
+            best = flag;
+        }
+    }
+    return best;
+}
+function levenshtein(a, b) {
+    const rows = a.length + 1;
+    const cols = b.length + 1;
+    const dp = new Array(rows * cols);
+    for (let i = 0; i < rows; i += 1)
+        dp[i * cols] = i;
+    for (let j = 0; j < cols; j += 1)
+        dp[j] = j;
+    for (let i = 1; i < rows; i += 1) {
+        for (let j = 1; j < cols; j += 1) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            dp[i * cols + j] = Math.min((dp[(i - 1) * cols + j] ?? 0) + 1, (dp[i * cols + j - 1] ?? 0) + 1, (dp[(i - 1) * cols + j - 1] ?? 0) + cost);
+        }
+    }
+    return dp[a.length * cols + b.length] ?? 0;
+}
+export function helpText(version) {
+    return `\
+agent-trace  v${version}
+Turn messy agent run logs into a readable timeline.
+
+Usage:
+  agent-trace [options] <file>
+  agent-trace [options] -                 Read from stdin
+  cat run.jsonl | agent-trace
+  agent-trace --demo                      Bundled sample (no file needed)
+
+Options:
+  -f, --format <fmt>     ${FORMAT_LIST} (default: auto)
+  -j, --json             Normalized trace as JSON
+      --stats            One-line summary only
+      --spicy            Narrative recap (offline, or LLM if API key set)
+      --fail-on-error    Exit 1 if the run had failures
+      --demo             Render bundled examples/run.jsonl
+      --ascii            ASCII-only timeline
+      --color            Force ANSI colors
+      --no-color         Disable ANSI colors (or set NO_COLOR)
+      --width <n>        Wrap width (default: terminal)
+      --max-content <n>  Truncate args/results (default: 160)
+  -h, --help             Show this help
+  -v, --version          Print version
+
+Formats:
+  openai      Chat Completions, messages[], Responses API, streaming deltas
+  langchain   LangSmith run trees, callback events, AgentAction dumps
+  jsonl       Role/tool/content events, Cursor-ish traces, generic objects
+  generic     JSON array (or { events: [...] }) of { type, name, content, ts }
+  auto        Sniff the file, then fall through the parsers above
+
+Exit codes:
+  0  ok
+  1  I/O or parse error; or --fail-on-error when the trace has failures
+  2  usage error (bad flag, missing file)
+
+Examples:
+  agent-trace --demo
+  agent-trace run.jsonl
+  agent-trace --format openai dump.json
+  agent-trace --json run.jsonl | jq .stats
+  agent-trace --fail-on-error --stats traces/ci.jsonl
+`;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+declare function main(argv: string[]): Promise<number>;
+export { main };
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAcA,iBAAe,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsEnD;AAuED,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/cli.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+import { readFileSync, realpathSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { helpText, parseArgs, UsageError } from "./args.js";
+import { createPalette, shouldColor } from "./color.js";
+import { parseTrace } from "./parse/index.js";
+import { readInput, wrapIoError } from "./read-input.js";
+import { spicyNarrative } from "./render/spicy.js";
+import { renderTimeline, summaryLine } from "./render/timeline.js";
+const VERSION = readVersion();
+async function main(argv) {
+    let args;
+    try {
+        args = parseArgs(argv);
+    }
+    catch (error) {
+        printErr(error);
+        return exitCodeFor(error);
+    }
+    if (args.help) {
+        process.stdout.write(helpText(VERSION));
+        return 0;
+    }
+    if (args.version) {
+        process.stdout.write(`agent-trace ${VERSION}\n`);
+        return 0;
+    }
+    let text;
+    let source;
+    try {
+        ({ text, source } = args.demo ? await readDemo() : await readInput(args.file));
+    }
+    catch (error) {
+        printErr(error);
+        return exitCodeFor(error);
+    }
+    let trace;
+    try {
+        trace = parseTrace(text, { format: args.format, source });
+    }
+    catch (error) {
+        printErr(error);
+        return 1;
+    }
+    if (args.json) {
+        const payload = {
+            format: trace.format,
+            source: trace.source,
+            stats: trace.stats,
+            warnings: trace.warnings,
+            steps: trace.steps,
+            ...(args.spicy ? { spicy: await spicyNarrative(trace) } : {}),
+        };
+        process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+        return failOnErrorCode(args.failOnError, trace.stats.failures);
+    }
+    if (args.stats) {
+        process.stdout.write(`${summaryLine(trace)}\n`);
+        for (const warning of trace.warnings) {
+            process.stderr.write(`agent-trace: warn: ${warning}\n`);
+        }
+    }
+    else {
+        const timeline = renderTimeline(trace, {
+            color: args.color,
+            ascii: args.ascii,
+            width: args.width,
+            maxContent: args.maxContent,
+        });
+        process.stdout.write(timeline);
+    }
+    if (args.spicy) {
+        const color = createPalette(shouldColor(args.color));
+        const narrative = await spicyNarrative(trace);
+        process.stdout.write(`\n${color.bold("spicy")}  ${narrative}\n`);
+    }
+    return failOnErrorCode(args.failOnError, trace.stats.failures);
+}
+function failOnErrorCode(enabled, failures) {
+    if (!enabled || failures <= 0)
+        return 0;
+    const noun = failures === 1 ? "failure" : "failures";
+    process.stderr.write(`agent-trace: ${failures} ${noun} (--fail-on-error)\n`);
+    return 1;
+}
+function printErr(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`agent-trace: ${message}\n`);
+    if (error instanceof UsageError) {
+        process.stderr.write("try 'agent-trace --help'\n");
+    }
+}
+function exitCodeFor(error) {
+    return error instanceof UsageError ? 2 : 1;
+}
+async function readDemo() {
+    const file = join(packageRoot(), "examples", "run.jsonl");
+    try {
+        const text = await readFile(file, "utf8");
+        return { text, source: "examples/run.jsonl" };
+    }
+    catch (error) {
+        const wrapped = wrapIoError(error, file);
+        if (wrapped.message.startsWith("file not found")) {
+            throw new Error("bundled demo missing (expected examples/run.jsonl in the package)");
+        }
+        throw wrapped;
+    }
+}
+function packageRoot() {
+    return join(dirname(fileURLToPath(import.meta.url)), "..");
+}
+function isCliEntry(argvPath) {
+    if (!argvPath)
+        return false;
+    const self = fileURLToPath(import.meta.url);
+    try {
+        return realpathSync(argvPath) === self || realpathSync(argvPath) === realpathSync(self);
+    }
+    catch {
+        return /(cli\.(js|ts)|agent-trace)$/.test(argvPath);
+    }
+}
+function readVersion() {
+    try {
+        const raw = readFileSync(join(packageRoot(), "package.json"), "utf8");
+        const parsed = JSON.parse(raw);
+        return parsed.version ?? "0.1.1";
+    }
+    catch {
+        return "0.1.1";
+    }
+}
+if (isCliEntry(process.argv[1])) {
+    main(process.argv).then((code) => {
+        process.exitCode = code;
+    }, (error) => {
+        printErr(error);
+        process.exitCode = 1;
+    });
+}
+export { main };
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/color.d.ts

@@ -0,0 +1,15 @@
+export interface Palette {
+    enabled: boolean;
+    bold: (s: string) => string;
+    dim: (s: string) => string;
+    italic: (s: string) => string;
+    red: (s: string) => string;
+    green: (s: string) => string;
+    yellow: (s: string) => string;
+    cyan: (s: string) => string;
+    magenta: (s: string) => string;
+    inverse: (s: string) => string;
+}
+export declare function createPalette(enabled: boolean): Palette;
+export declare function shouldColor(flag?: boolean): boolean;
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5B,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/B,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAChC;AAMD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAavD;AAED,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAMnD"}

package/dist/color.js

@@ -0,0 +1,29 @@
+function wrap(enabled, open, close) {
+    return (s) => (enabled ? `\u001b[${open}m${s}\u001b[${close}m` : s);
+}
+export function createPalette(enabled) {
+    return {
+        enabled,
+        bold: wrap(enabled, "1", "22"),
+        dim: wrap(enabled, "2", "22"),
+        italic: wrap(enabled, "3", "23"),
+        red: wrap(enabled, "91", "39"),
+        green: wrap(enabled, "32", "39"),
+        yellow: wrap(enabled, "33", "39"),
+        cyan: wrap(enabled, "36", "39"),
+        magenta: wrap(enabled, "35", "39"),
+        inverse: wrap(enabled, "7", "27"),
+    };
+}
+export function shouldColor(flag) {
+    if (flag === false)
+        return false;
+    if (process.env.NO_COLOR)
+        return false;
+    if (process.env.FORCE_COLOR === "0")
+        return false;
+    if (flag === true)
+        return true;
+    return Boolean(process.stdout.isTTY);
+}
+//# sourceMappingURL=color.js.map

package/dist/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAaA,SAAS,IAAI,CAAC,OAAgB,EAAE,IAAY,EAAE,KAAa;IACzD,OAAO,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO;QACL,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAC9B,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAC7B,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAChC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC;QAC9B,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC;QAChC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC;QACjC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC;QAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC;QAClC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACjC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { ParseOptions, RenderOptions, SpicyOptions, StepKind, Trace, TraceFormat, TraceStats, TraceStep, } from "./types.js";
+export { parseTrace } from "./parse/index.js";
+export { parseOpenAI } from "./parse/openai.js";
+export { parseLangChain } from "./parse/langchain.js";
+export { parseJsonl } from "./parse/jsonl.js";
+export { parseGeneric } from "./parse/generic.js";
+export { renderTimeline, summaryLine } from "./render/timeline.js";
+export { spicyNarrative, localSpicy } from "./render/spicy.js";
+export { computeStats } from "./stats.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,KAAK,EACL,WAAW,EACX,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}