katt 0.0.5 → 0.0.7

package/README.md

@@ -9,6 +9,7 @@ Katt is a lightweight testing framework for running AI Evals, inspired by [Jest]
 
 - [Overview](#overview)
 - [API Documentation](#api-documentation)
+- [Articles](#articles)
 - [Hello World - Example](#hello-world---example)
 - [Main Features](#main-features)
 - [Usage](#usage)
@@ -34,6 +35,10 @@ Katt is designed to evaluate and validate the behavior of AI agents like **Claud
 
 For a complete list of features and usage examples, see [docs/api-documentation.md](https://github.com/raphaelpor/katt/blob/main/docs/api-documentation.md).
 
+## Articles
+
+- [Introducing Katt](https://github.com/raphaelpor/katt/blob/main/docs/articles/introduction-to-katt.md)
+
 ## Hello World - Example
 
 ```typescript
@@ -86,7 +91,7 @@ expect(result).toContain("hello world");
 2. Run Katt from your project directory:
 
 ```bash
-katt
+npx katt
 ```
 
 ### Using promptFile

package/dist/index.js

@@ -1,21 +1,21 @@
-import { r as E, c as N, a as O, p as I, b as m, l as d, d as w, g as F, e as U, f as C, s as _, h as R, i as D, j as z, k as B, m as W, n as K } from "./runCli-CDRmZ5hw.js";
-import { o as St } from "./runCli-CDRmZ5hw.js";
-import { CopilotClient as H } from "@github/copilot-sdk";
-import { readFile as A } from "node:fs/promises";
-import { resolve as j, dirname as T, isAbsolute as Y, basename as J, join as q } from "node:path";
-import { readFileSync as G, writeFileSync as S, mkdirSync as Q } from "node:fs";
-function vt(t, e) {
+import { r as E, c as N, a as O, p as I, b as m, l as d, d as w, g as S, e as U, f as C, s as z, h as R, i as A, j as B, k as W, m as K, n as H, o as Y, q } from "./runCli-C7uxWavX.js";
+import { t as Et } from "./runCli-C7uxWavX.js";
+import { CopilotClient as J } from "@github/copilot-sdk";
+import { readFile as j } from "node:fs/promises";
+import { resolve as P, dirname as v, isAbsolute as G, basename as Q, join as V } from "node:path";
+import { readFileSync as X, writeFileSync as F, mkdirSync as Z } from "node:fs";
+function Tt(t, e) {
   E(() => {
     O(), I(t);
-    const n = F(), r = Date.now(), i = () => F() === n, o = () => Date.now() - r;
+    const n = S(), o = Date.now(), i = () => S() === n, r = () => Date.now() - o;
     try {
       const s = e();
       if (s && typeof s.then == "function") {
         m(
           s.then(() => {
-            d(!0, o());
+            d(!0, r());
           }).catch((a) => {
-            throw d(!1, o()), a;
+            throw d(!1, r()), a;
           }).finally(() => {
             w();
           })
@@ -23,12 +23,12 @@ function vt(t, e) {
         return;
       }
     } catch (s) {
-      throw d(!1, o()), w(), s;
+      throw d(!1, r()), w(), s;
     }
-    d(i(), o()), w();
+    d(i(), r()), w();
   }, N());
 }
-function Tt(t, e) {
+function St(t, e) {
   E(() => {
     U(t);
     try {
@@ -47,10 +47,10 @@ function Tt(t, e) {
     C();
   }, N());
 }
-function V(t, e) {
+function tt(t, e) {
   return typeof t == "object" && t !== null && "code" in t && t.code === e;
 }
-function X(t) {
+function et(t) {
   try {
     const e = JSON.parse(t);
     return typeof e == "object" && e !== null ? e : void 0;
@@ -59,53 +59,53 @@ function X(t) {
     return;
   }
 }
-async function Z() {
-  const t = j(process.cwd(), "katt.json");
+async function nt() {
+  const t = P(process.cwd(), "katt.json");
   try {
-    const e = await A(t, "utf8");
-    return X(e);
+    const e = await j(t, "utf8");
+    return et(e);
   } catch (e) {
-    if (V(e, "ENOENT"))
+    if (tt(e, "ENOENT"))
       return;
     console.warn(`Failed to read katt.json: ${String(e)}`);
     return;
   }
 }
-function tt(t) {
+function ot(t) {
   const e = t?.copilot;
   if (typeof e != "object" || e === null || Array.isArray(e))
     return;
   const n = {
     ...e
-  }, r = n.model;
-  return (typeof r != "string" || r.length === 0) && delete n.model, Object.keys(n).length > 0 ? n : void 0;
+  }, o = n.model;
+  return (typeof o != "string" || o.length === 0) && delete n.model, Object.keys(n).length > 0 ? n : void 0;
 }
-function et(t) {
+function rt(t) {
   if (!(typeof t != "number" || !Number.isFinite(t)) && !(t <= 0))
     return Math.floor(t);
 }
-function nt(t) {
+function it(t) {
   const e = t?.prompt;
   if (!(typeof e != "object" || e === null || Array.isArray(e)))
-    return et(e.timeoutMs);
+    return rt(e.timeoutMs);
 }
-async function ot() {
-  const t = await Z();
+async function st() {
+  const t = await nt();
   return {
-    copilot: tt(t),
-    promptTimeoutMs: nt(t)
+    copilot: ot(t),
+    promptTimeoutMs: it(t)
   };
 }
-const rt = 6e5;
-function P(t) {
+const at = 6e5;
+function _(t) {
   return typeof t == "string" && t.length > 0 ? t : void 0;
 }
-function v(t) {
+function b(t) {
   if (!t)
     return;
   const e = { ...t };
   if (e.model !== void 0) {
-    const n = P(e.model);
+    const n = _(e.model);
     n ? e.model = n : delete e.model;
   }
   return Object.keys(e).length > 0 ? e : void 0;
@@ -117,28 +117,28 @@ function M(t) {
 function h(t) {
   return !Number.isFinite(t) || (t ?? 0) <= 0 ? 0 : Math.floor(t ?? 0);
 }
-function it(t) {
+function ct(t) {
   return h(t.inputTokens) + h(t.outputTokens) + h(t.cacheReadTokens) + h(t.cacheWriteTokens);
 }
 async function $(t, e = {}) {
-  const { timeoutMs: n, ...r } = e, i = await ot(), o = v(i.copilot), s = v(
-    r
-  ), a = v({
-    ...o ?? {},
+  const { timeoutMs: n, ...o } = e, i = await st(), r = b(i.copilot), s = b(
+    o
+  ), a = b({
+    ...r ?? {},
     ...s ?? {}
-  }), c = M(i.promptTimeoutMs), L = M(n) ?? c ?? rt, b = P(a?.model), g = new H({ useLoggedInUser: !0 });
-  let p, x, y = 0;
+  }), c = M(i.promptTimeoutMs), L = M(n) ?? c ?? at, x = _(a?.model), g = new J({ useLoggedInUser: !0 });
+  let p, T, y = 0;
   try {
-    await g.start(), p = await g.createSession(a), x = p.on("assistant.usage", (f) => {
-      y += it(f.data);
+    await g.start(), p = await g.createSession(a), T = p.on("assistant.usage", (f) => {
+      y += ct(f.data);
     });
     const l = await p.sendAndWait({ prompt: t }, L);
     if (!l?.data?.content)
       throw new Error("Copilot did not return a response.");
-    return b && _(b), l.data.content;
+    return x && z(x), l.data.content;
   } finally {
     const l = [];
-    if (x?.(), y > 0 && R(y), p)
+    if (T?.(), y > 0 && R(y), p)
       try {
         await p.destroy();
       } catch (f) {
@@ -155,37 +155,37 @@ async function $(t, e = {}) {
     );
   }
 }
-async function $t(t, e = {}) {
-  const n = D.getStore(), r = n?.evalFile ? T(n.evalFile) : process.cwd(), i = Y(t) ? t : j(r, t), o = await A(i, "utf8");
-  return $(o, e);
+async function Ft(t, e = {}) {
+  const n = A.getStore(), o = n?.evalFile ? v(n.evalFile) : process.cwd(), i = G(t) ? t : P(o, t), r = await j(i, "utf8");
+  return $(r, e);
 }
 function u(t) {
-  z({
-    describePath: W(),
-    itPath: B(),
+  B({
+    describePath: K(),
+    itPath: W(),
     message: t
   });
 }
-async function st(t, e) {
-  const n = Date.now(), r = `expected '${t}' to satisfy '${e}'`, i = $(`Evaluate if the expectation is fulfiled in by the input.
+async function ut(t, e) {
+  const n = Date.now(), o = `expected '${t}' to satisfy '${e}'`, i = $(`Evaluate if the expectation is fulfiled in by the input.
         Expectation: "${e}".
         Input:
         ---
         ${t}
         ---
         Important: Answer with "Yes" or "No" only, without any additional text.
-        `).then((o) => {
-    o.includes("Yes") ? d(!0, Date.now() - n, "promptCheck") : o.includes("No") ? u(r) : u(`failed to evaluate expectation '${e}'`);
+        `).then((r) => {
+    r.includes("Yes") ? d(!0, Date.now() - n, "promptCheck") : r.includes("No") ? u(o) : u(`failed to evaluate expectation '${e}'`);
   });
   return m(i), i;
 }
-const at = 3;
-function ct(t) {
+const lt = 3;
+function ft(t) {
   const e = t.match(/\b([1-5])\b/);
   return !e || !e[1] ? null : Number(e[1]);
 }
-async function ut(t, e, n) {
-  const r = Date.now(), i = n?.threshold ?? at, o = $(
+async function dt(t, e, n) {
+  const o = Date.now(), i = n?.threshold ?? lt, r = $(
     `Classify the input by how "${e}" it is on a scale of 1 to 5.
 1 means "not ${e}" and 5 means "very ${e}".
 Return only a single number: 1, 2, 3, 4, or 5.
@@ -196,7 +196,7 @@ ${t}
 ---`,
     n?.model ? { model: n.model } : void 0
   ).then((s) => {
-    const a = ct(s);
+    const a = ft(s);
     if (a === null) {
       u(
         `failed to classify as '${e}'. Evaluator returned '${s}'`
@@ -210,66 +210,78 @@ ${t}
     }
     d(
       !0,
-      Date.now() - r,
+      Date.now() - o,
       "toBeClassifiedAs"
     );
   });
-  return m(o), o;
+  return m(r), r;
 }
-function lt(t, e) {
+function pt(t, e) {
   const n = `expected '${t}' to include '${e}'`;
   t.includes(e) || u(n);
 }
-function ft(t) {
-  const n = J(t).replace(/\.eval\.[^./\\]+$/, "");
-  return q(
-    T(t),
+function k(t) {
+  const e = t.trim().replace(/[<>:"/\\|?*\x00-\x1f]/g, "_").replace(/\s+/g, "_");
+  return e.length > 0 ? e : "unnamed";
+}
+function ht() {
+  const t = Y().map(
+    (o) => k(o.description)
+  ), e = q().map(
+    (o) => k(o.description)
+  ), n = [...t, ...e];
+  return n.length === 0 ? "root" : n.join("__");
+}
+function mt(t) {
+  const n = Q(t).replace(/\.eval\.[^./\\]+$/, ""), o = ht();
+  return V(
+    v(t),
     "__snapshots__",
-    `${n}.snap.md`
+    `${n}__${o}.snap.md`
   );
 }
-function k(t) {
+function D(t) {
   return t.split(/\r?\n/);
 }
-function dt(t, e) {
+function gt(t, e) {
   if (t === e)
     return "  (no diff)";
-  const n = k(t), r = k(e), i = Math.max(n.length, r.length), o = [];
+  const n = D(t), o = D(e), i = Math.max(n.length, o.length), r = [];
   for (let s = 0; s < i; s += 1) {
-    const a = n[s], c = r[s];
+    const a = n[s], c = o[s];
     if (a !== c) {
       if (a === void 0 && c !== void 0) {
-        o.push(`+ ${c}`);
+        r.push(`+ ${c}`);
         continue;
       }
       if (a !== void 0 && c === void 0) {
-        o.push(`- ${a}`);
+        r.push(`- ${a}`);
         continue;
       }
-      o.push(`- ${a ?? ""}`), o.push(`+ ${c ?? ""}`);
+      r.push(`- ${a ?? ""}`), r.push(`+ ${c ?? ""}`);
     }
   }
-  return o.join(`
+  return r.join(`
 `);
 }
-function pt(t) {
-  const e = D.getStore()?.evalFile;
+function yt(t) {
+  const e = A.getStore()?.evalFile;
   if (!e) {
     u(
       "toMatchSnapshot can only be used while running an eval file."
     );
     return;
   }
-  const n = ft(e);
+  const n = mt(e);
   try {
-    const r = G(n, "utf8");
-    if (r === t)
+    const o = X(n, "utf8");
+    if (o === t)
       return;
-    if (K()) {
-      S(n, t, "utf8");
+    if (H()) {
+      F(n, t, "utf8");
       return;
     }
-    const i = dt(r, t);
+    const i = gt(o, t);
     u(
       [
         `Snapshot mismatch at ${n}`,
@@ -277,47 +289,47 @@ function pt(t) {
         "Diff:",
         i,
         "",
-        "Run katt with --update-snapshots (or -u) to accept this change."
+        "Run 'npx katt --update-snapshots' (or -u) to accept this change."
       ].join(`
 `)
     );
-  } catch (r) {
-    if (r.code !== "ENOENT") {
+  } catch (o) {
+    if (o.code !== "ENOENT") {
       u(
-        `Failed to read snapshot at ${n}: ${String(r)}`
+        `Failed to read snapshot at ${n}: ${String(o)}`
       );
       return;
     }
     try {
-      Q(T(n), { recursive: !0 }), S(n, t, "utf8");
-    } catch (o) {
+      Z(v(n), { recursive: !0 }), F(n, t, "utf8");
+    } catch (r) {
       u(
-        `Failed to write snapshot at ${n}: ${String(o)}`
+        `Failed to write snapshot at ${n}: ${String(r)}`
       );
     }
   }
 }
-function bt(t) {
+function Mt(t) {
   return {
     toContain: (e) => {
-      lt(t, e);
+      pt(t, e);
     },
     toMatchSnapshot: () => {
-      pt(t);
+      yt(t);
     },
     promptCheck: async (e) => {
-      await st(t, e);
+      await ut(t, e);
     },
     toBeClassifiedAs: async (e, n) => {
-      await ut(t, e, n);
+      await dt(t, e, n);
     }
   };
 }
 export {
-  Tt as describe,
-  bt as expect,
-  vt as it,
+  St as describe,
+  Mt as expect,
+  Tt as it,
   $ as prompt,
-  $t as promptFile,
-  St as runCli
+  Ft as promptFile,
+  Et as runCli
 };

package/dist/katt.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { o as r } from "./runCli-CDRmZ5hw.js";
+import { t as r } from "./runCli-C7uxWavX.js";
 r().then((e) => {
   process.exit(e);
 }).catch((e) => {

package/dist/runCli-C7uxWavX.js

@@ -0,0 +1,312 @@
+import { fileURLToPath as T, pathToFileURL as X } from "node:url";
+import { readdir as M } from "node:fs/promises";
+import { resolve as R } from "node:path";
+import { AsyncLocalStorage as v } from "node:async_hooks";
+import { readFileSync as U } from "node:fs";
+const W = /\.eval\.(js|ts)$/, G = /* @__PURE__ */ new Set([".git", "node_modules"]);
+async function J(t) {
+  const e = await M(t, { withFileTypes: !0 }), n = [];
+  return await Promise.all(
+    e.map(async (o) => {
+      const a = R(t, o.name);
+      if (o.isDirectory()) {
+        if (G.has(o.name))
+          return;
+        n.push(...await J(a));
+        return;
+      }
+      o.isFile() && W.test(o.name) && n.push(a);
+    })
+  ), n;
+}
+const B = new v(), O = {
+  describeStack: [],
+  itStack: [],
+  tokenUsageStack: [],
+  modelStack: []
+};
+let L = 0, $ = 0;
+const f = [], h = [];
+let k = 0;
+function i() {
+  return B.getStore() ?? O;
+}
+function Z(t) {
+  return {
+    describeStack: [...t.describeStack],
+    itStack: [...t.itStack],
+    tokenUsageStack: [...t.tokenUsageStack],
+    modelStack: [...t.modelStack]
+  };
+}
+function Y() {
+  return L += 1, `d${L}`;
+}
+function Q() {
+  return $ += 1, `i${$}`;
+}
+function St(t, e) {
+  const n = e ?? Z(i());
+  return B.run(n, t);
+}
+function At() {
+  return Z(i());
+}
+function kt(t) {
+  i().describeStack.push({ id: Y(), description: t });
+}
+function bt() {
+  i().describeStack.pop();
+}
+function V() {
+  return i().describeStack.map((t) => t.description).join(" > ");
+}
+function Lt() {
+  return [...i().describeStack];
+}
+function $t(t) {
+  i().itStack.push({ id: Q(), description: t }), i().tokenUsageStack.push(0), i().modelStack.push(void 0);
+}
+function wt() {
+  i().itStack.pop(), i().tokenUsageStack.pop(), i().modelStack.pop();
+}
+function K() {
+  return i().itStack.map((t) => t.description).join(" > ");
+}
+function jt() {
+  return [...i().itStack];
+}
+function vt(t) {
+  if (!Number.isFinite(t) || t <= 0)
+    return;
+  const e = i(), n = e.tokenUsageStack.length - 1;
+  n < 0 || (e.tokenUsageStack[n] += t);
+}
+function P() {
+  const t = i(), e = t.tokenUsageStack.length - 1;
+  return e < 0 ? 0 : t.tokenUsageStack[e] ?? 0;
+}
+function Jt(t) {
+  if (t.length === 0)
+    return;
+  const e = i(), n = e.modelStack.length - 1;
+  n < 0 || (e.modelStack[n] = t);
+}
+function z() {
+  const t = i(), e = t.modelStack.length - 1;
+  if (!(e < 0))
+    return t.modelStack[e];
+}
+function Bt(t) {
+  f.push(t);
+}
+function Zt() {
+  k += 1;
+}
+function E() {
+  return k;
+}
+function D() {
+  k = 0;
+}
+function xt(t) {
+  h.push(t);
+}
+function _() {
+  return [...h];
+}
+function Ht() {
+  return h.length;
+}
+function q() {
+  h.length = 0;
+}
+async function tt() {
+  const t = [];
+  for (; f.length > 0; ) {
+    const e = f.splice(0, f.length), n = await Promise.allSettled(e);
+    t.push(...n);
+  }
+  return t;
+}
+const et = "\x1B[1;36m", nt = "\x1B[33m", ot = "\x1B[38;5;208m", it = "\x1B[1;38;5;208m", m = "\x1B[0m";
+function r(t) {
+  return `${et}${t}${m}`;
+}
+function p(t) {
+  return `${nt}${t}${m}`;
+}
+function w(t) {
+  return `${ot}${t}${m}`;
+}
+function st(t) {
+  return `${it}${t}${m}`;
+}
+let A = "";
+function at() {
+  A = "";
+}
+function ct({
+  suitePath: t,
+  casePath: e,
+  didPass: n,
+  durationMs: o,
+  model: a,
+  tokenUsage: I
+}) {
+  const c = t.length > 0 ? t : "(root)", C = e.length > 0 ? e : "(root)";
+  A !== c && (console.log(`Suite "${r(c)}"`), A = c);
+  const g = n ? "✅ Passed in" : "❌ Failed in", l = [
+    `Test "${r(C)}"`,
+    `- ${g} ${r(`${o}ms`)}`
+  ];
+  a && l.push(`- Model ${r(a)}`), (I ?? 0) > 0 && l.push(`- Tokens used ${r(String(I))}`), l.push("---"), console.log(l.join(`
+`));
+}
+function yt(t, e, n = "(root)") {
+  const o = K();
+  ct({
+    suitePath: V(),
+    casePath: o.length > 0 ? o : n,
+    didPass: t,
+    durationMs: e,
+    model: z(),
+    tokenUsage: P()
+  });
+}
+const rt = new v(), S = new URL("data:application/json;base64,ewogICJuYW1lIjogImthdHQiLAogICJ2ZXJzaW9uIjogIjAuMC42IiwKICAiZGVzY3JpcHRpb24iOiAiQ0xJIHRvb2wgdGhhdCB0ZXN0cyB0aGUgb3V0cHV0IG9mIGFnZW50aWMgQUkgdG9vbHMiLAogICJrZXl3b3JkcyI6IFsKICAgICJjbGkiLAogICAgImFpIiwKICAgICJhZ2VudGljLWFpIiwKICAgICJ0ZXN0aW5nIiwKICAgICJldmFsdWF0aW9uIgogIF0sCiAgImF1dGhvciI6ICJSYXBoYWVsIFBvcnRvIChodHRwczovL2dpdGh1Yi5jb20vcmFwaGFlbHBvcikiLAogICJsaWNlbnNlIjogIk1JVCIsCiAgInR5cGUiOiAibW9kdWxlIiwKICAibWFpbiI6ICJkaXN0L2luZGV4LmpzIiwKICAiZXhwb3J0cyI6IHsKICAgICIuIjogewogICAgICAidHlwZXMiOiAiLi9kaXN0L2luZGV4LmQudHMiLAogICAgICAiaW1wb3J0IjogIi4vZGlzdC9pbmRleC5qcyIKICAgIH0KICB9LAogICJiaW4iOiB7CiAgICAia2F0dCI6ICJkaXN0L2thdHQuanMiCiAgfSwKICAic2NyaXB0cyI6IHsKICAgICJidWlsZCI6ICJ2aXRlIGJ1aWxkIiwKICAgICJkZXYiOiAidHN4IHNyYy9pbmRleC50cyIsCiAgICAibGludCI6ICJiaW9tZSBsaW50IC4vc3JjIiwKICAgICJmb3JtYXQiOiAiYmlvbWUgZm9ybWF0IC0td3JpdGUgLi9zcmMiLAogICAgInRlc3QiOiAidml0ZXN0IiwKICAgICJ0eXBlY2hlY2siOiAidHNjIC1wIHRzY29uZmlnLmpzb24gLS1ub0VtaXQiLAogICAgInRlc3Q6YnVpbGQiOiAibm9kZSAuL2Rpc3Qva2F0dC5qcyIKICB9LAogICJ0eXBlcyI6ICJkaXN0L2luZGV4LmQudHMiLAogICJkZXZEZXBlbmRlbmNpZXMiOiB7CiAgICAiQGJpb21lanMvYmlvbWUiOiAiMS45LjQiLAogICAgIkB0eXBlcy9ub2RlIjogIjI1LjIuMCIsCiAgICAidHN4IjogIjQuMjEuMCIsCiAgICAidHlwZXNjcmlwdCI6ICI1LjguMiIsCiAgICAidml0ZSI6ICI3LjMuMSIsCiAgICAidml0ZS1wbHVnaW4tZHRzIjogIjQuNS40IiwKICAgICJ2aXRlc3QiOiAiMy4yLjQiLAogICAgInZzY29kZS1qc29ucnBjIjogIl44LjIuMSIKICB9LAogICJkZXBlbmRlbmNpZXMiOiB7CiAgICAiQGdpdGh1Yi9jb3BpbG90LXNkayI6ICJeMC4xLjIxIgogIH0sCiAgImJ1Z3MiOiB7CiAgICAidXJsIjogImh0dHBzOi8vZ2l0aHViLmNvbS9yYXBoYWVscG9yL2thdHQvaXNzdWVzIgogIH0sCiAgImhvbWVwYWdlIjogImh0dHBzOi8vZ2l0aHViLmNvbS9yYXBoYWVscG9yL2thdHQiCn0K", import.meta.url);
+let d;
+function lt() {
+  if (d !== void 0)
+    return d;
+  try {
+    const t = S.protocol === "data:" ? ut(S) : U(T(S), "utf8"), e = JSON.parse(t);
+    d = typeof e.version == "string" ? e.version : "unknown";
+  } catch {
+    d = "unknown";
+  }
+  return d;
+}
+function ut(t) {
+  const e = t.pathname.indexOf(",");
+  if (e < 0)
+    throw new Error("Invalid data URL.");
+  const n = t.pathname.slice(0, e), o = t.pathname.slice(e + 1);
+  return n.includes(";base64") ? Buffer.from(o, "base64").toString("utf8") : decodeURIComponent(o);
+}
+function j() {
+  const t = " ██╗  ██╗ █████╗ ████████╗████████╗", e = " ██║ ██╔╝██╔══██╗╚══██╔══╝╚══██╔══╝", n = " █████╔╝ ███████║   ██║      ██║", o = " ██╔═██╗ ██╔══██║   ██║      ██║", a = " ██║  ██╗██║  ██║   ██║      ██║", I = " ╚═╝  ╚═╝╚═╝  ╚═╝   ╚═╝      ╚═╝", c = `v${lt()}`, C = Math.max(
+    0,
+    Math.floor((t.length - c.length) / 2)
+  ), g = `${" ".repeat(C)}${c}`;
+  console.log(`
+${p(t)}
+${p(e)}
+${p(n)}
+${w(o)}
+${w(a)}
+${st(I)}
+${p(g)}
+`);
+}
+let x = !1;
+function gt(t) {
+  x = t;
+}
+function Ft() {
+  return x;
+}
+function It(t) {
+  const e = String(t.getHours()).padStart(2, "0"), n = String(t.getMinutes()).padStart(2, "0"), o = String(t.getSeconds()).padStart(2, "0");
+  return `${e}:${n}:${o}`;
+}
+function dt() {
+  console.log(
+    [
+      "Usage:",
+      "  katt [options]",
+      "",
+      "Options:",
+      "  -h, --help              Show CLI usage information",
+      "  -u, --update-snapshots  Update snapshot files on mismatch"
+    ].join(`
+`)
+  );
+}
+async function Nt() {
+  const t = process.argv.slice(2);
+  if (t.includes("--help") || t.includes("-h"))
+    return j(), dt(), 0;
+  const n = t.includes("--update-snapshots") || t.includes("-u");
+  gt(n), j();
+  const o = /* @__PURE__ */ new Date();
+  at(), q(), D();
+  const a = await J(process.cwd());
+  if (a.length === 0)
+    return console.log("No .eval.js or .eval.ts files found."), 1;
+  const c = (await Promise.allSettled(
+    a.map(
+      (s) => rt.run(
+        { evalFile: s },
+        () => import(X(s).href)
+      )
+    )
+  )).map((s, u) => ({ result: s, file: a[u] })).filter(({ result: s }) => s.status === "rejected");
+  if (c.length > 0) {
+    for (const s of c) {
+      const u = s.result.status === "rejected" ? s.result.reason : void 0;
+      console.error(`Error executing ${s.file}: ${String(u)}`);
+    }
+    return 1;
+  }
+  const g = (await tt()).filter(
+    (s) => s.status === "rejected"
+  );
+  if (g.length > 0) {
+    for (const s of g)
+      s.status === "rejected" && console.error(`Error executing async test: ${String(s.reason)}`);
+    return 1;
+  }
+  const l = _();
+  if (l.length > 0) {
+    console.error("❌ Failed tests:");
+    for (const [s, u] of l.entries()) {
+      const b = [u.describePath, u.itPath].filter((N) => N.length > 0).join(" > "), F = b.length > 0 ? `${b}: ` : "";
+      console.error(`${s + 1}. ${F}${u.message}`);
+    }
+    return 1;
+  }
+  const H = E(), y = Date.now() - o.getTime();
+  return console.log(
+    [
+      "---",
+      `${r("Files")}  ${a.length} passed`,
+      `${r("Evals")}  ${H} passed`,
+      `${r("Start at")}  ${It(o)}`,
+      `${r("Duration")}  ${y}ms`
+    ].join(`
+`)
+  ), 0;
+}
+export {
+  Zt as a,
+  Bt as b,
+  At as c,
+  wt as d,
+  kt as e,
+  bt as f,
+  Ht as g,
+  vt as h,
+  rt as i,
+  xt as j,
+  K as k,
+  yt as l,
+  V as m,
+  Ft as n,
+  Lt as o,
+  $t as p,
+  jt as q,
+  St as r,
+  Jt as s,
+  Nt as t
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "katt",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "CLI tool that tests the output of agentic AI tools",
   "keywords": [
     "cli",

package/dist/runCli-CDRmZ5hw.js

@@ -1,288 +0,0 @@
-import { fileURLToPath as x, pathToFileURL as y } from "node:url";
-import { readdir as X } from "node:fs/promises";
-import { resolve as H } from "node:path";
-import { AsyncLocalStorage as j } from "node:async_hooks";
-import { readFileSync as M } from "node:fs";
-const R = /\.eval\.(js|ts)$/, W = /* @__PURE__ */ new Set([".git", "node_modules"]);
-async function v(t) {
-  const e = await X(t, { withFileTypes: !0 }), n = [];
-  return await Promise.all(
-    e.map(async (o) => {
-      const a = H(t, o.name);
-      if (o.isDirectory()) {
-        if (W.has(o.name))
-          return;
-        n.push(...await v(a));
-        return;
-      }
-      o.isFile() && R.test(o.name) && n.push(a);
-    })
-  ), n;
-}
-const J = new j(), G = {
-  describeStack: [],
-  itStack: [],
-  tokenUsageStack: [],
-  modelStack: []
-};
-let L = 0, $ = 0;
-const p = [], m = [];
-let k = 0;
-function s() {
-  return J.getStore() ?? G;
-}
-function B(t) {
-  return {
-    describeStack: [...t.describeStack],
-    itStack: [...t.itStack],
-    tokenUsageStack: [...t.tokenUsageStack],
-    modelStack: [...t.modelStack]
-  };
-}
-function U() {
-  return L += 1, `d${L}`;
-}
-function O() {
-  return $ += 1, `i${$}`;
-}
-function mt(t, e) {
-  const n = e ?? B(s());
-  return J.run(n, t);
-}
-function ht() {
-  return B(s());
-}
-function St(t) {
-  s().describeStack.push({ id: U(), description: t });
-}
-function At() {
-  s().describeStack.pop();
-}
-function Y() {
-  return s().describeStack.map((t) => t.description).join(" > ");
-}
-function kt(t) {
-  s().itStack.push({ id: O(), description: t }), s().tokenUsageStack.push(0), s().modelStack.push(void 0);
-}
-function bt() {
-  s().itStack.pop(), s().tokenUsageStack.pop(), s().modelStack.pop();
-}
-function Q() {
-  return s().itStack.map((t) => t.description).join(" > ");
-}
-function Lt(t) {
-  if (!Number.isFinite(t) || t <= 0)
-    return;
-  const e = s(), n = e.tokenUsageStack.length - 1;
-  n < 0 || (e.tokenUsageStack[n] += t);
-}
-function V() {
-  const t = s(), e = t.tokenUsageStack.length - 1;
-  return e < 0 ? 0 : t.tokenUsageStack[e] ?? 0;
-}
-function $t(t) {
-  if (t.length === 0)
-    return;
-  const e = s(), n = e.modelStack.length - 1;
-  n < 0 || (e.modelStack[n] = t);
-}
-function K() {
-  const t = s(), e = t.modelStack.length - 1;
-  if (!(e < 0))
-    return t.modelStack[e];
-}
-function wt(t) {
-  p.push(t);
-}
-function jt() {
-  k += 1;
-}
-function P() {
-  return k;
-}
-function z() {
-  k = 0;
-}
-function vt(t) {
-  m.push(t);
-}
-function E() {
-  return [...m];
-}
-function Jt() {
-  return m.length;
-}
-function D() {
-  m.length = 0;
-}
-async function _() {
-  const t = [];
-  for (; p.length > 0; ) {
-    const e = p.splice(0, p.length), n = await Promise.allSettled(e);
-    t.push(...n);
-  }
-  return t;
-}
-const q = "\x1B[1;36m", tt = "\x1B[33m", et = "\x1B[38;5;208m", nt = "\x1B[1;38;5;208m", h = "\x1B[0m";
-function c(t) {
-  return `${q}${t}${h}`;
-}
-function f(t) {
-  return `${tt}${t}${h}`;
-}
-function w(t) {
-  return `${et}${t}${h}`;
-}
-function ot(t) {
-  return `${nt}${t}${h}`;
-}
-let A = "";
-function it() {
-  A = "";
-}
-function st({
-  suitePath: t,
-  casePath: e,
-  didPass: n,
-  durationMs: o,
-  model: a,
-  tokenUsage: r
-}) {
-  const l = t.length > 0 ? t : "(root)", g = e.length > 0 ? e : "(root)";
-  A !== l && (console.log(`Suite "${c(l)}"`), A = l);
-  const I = n ? "✅ Passed in" : "❌ Failed in", d = [
-    `Test "${c(g)}"`,
-    `- ${I} ${c(`${o}ms`)}`
-  ];
-  a && d.push(`- Model ${c(a)}`), (r ?? 0) > 0 && d.push(`- Tokens used ${c(String(r))}`), d.push("---"), console.log(d.join(`
-`));
-}
-function Bt(t, e, n = "(root)") {
-  const o = Q();
-  st({
-    suitePath: Y(),
-    casePath: o.length > 0 ? o : n,
-    didPass: t,
-    durationMs: e,
-    model: K(),
-    tokenUsage: V()
-  });
-}
-const at = new j(), S = new URL("data:application/json;base64,ewogICJuYW1lIjogImthdHQiLAogICJ2ZXJzaW9uIjogIjAuMC40IiwKICAiZGVzY3JpcHRpb24iOiAiQ0xJIHRvb2wgdGhhdCB0ZXN0cyB0aGUgb3V0cHV0IG9mIGFnZW50aWMgQUkgdG9vbHMiLAogICJrZXl3b3JkcyI6IFsKICAgICJjbGkiLAogICAgImFpIiwKICAgICJhZ2VudGljLWFpIiwKICAgICJ0ZXN0aW5nIiwKICAgICJldmFsdWF0aW9uIgogIF0sCiAgImF1dGhvciI6ICJSYXBoYWVsIFBvcnRvIChodHRwczovL2dpdGh1Yi5jb20vcmFwaGFlbHBvcikiLAogICJsaWNlbnNlIjogIk1JVCIsCiAgInR5cGUiOiAibW9kdWxlIiwKICAibWFpbiI6ICJkaXN0L2luZGV4LmpzIiwKICAiZXhwb3J0cyI6IHsKICAgICIuIjogewogICAgICAidHlwZXMiOiAiLi9kaXN0L2luZGV4LmQudHMiLAogICAgICAiaW1wb3J0IjogIi4vZGlzdC9pbmRleC5qcyIKICAgIH0KICB9LAogICJiaW4iOiB7CiAgICAia2F0dCI6ICJkaXN0L2thdHQuanMiCiAgfSwKICAic2NyaXB0cyI6IHsKICAgICJidWlsZCI6ICJ2aXRlIGJ1aWxkIiwKICAgICJkZXYiOiAidHN4IHNyYy9pbmRleC50cyIsCiAgICAibGludCI6ICJiaW9tZSBsaW50IC4vc3JjIiwKICAgICJmb3JtYXQiOiAiYmlvbWUgZm9ybWF0IC0td3JpdGUgLi9zcmMiLAogICAgInRlc3QiOiAidml0ZXN0IiwKICAgICJ0eXBlY2hlY2siOiAidHNjIC1wIHRzY29uZmlnLmpzb24gLS1ub0VtaXQiLAogICAgInRlc3Q6YnVpbGQiOiAibm9kZSAuL2Rpc3Qva2F0dC5qcyIKICB9LAogICJ0eXBlcyI6ICJkaXN0L2luZGV4LmQudHMiLAogICJkZXZEZXBlbmRlbmNpZXMiOiB7CiAgICAiQGJpb21lanMvYmlvbWUiOiAiMS45LjQiLAogICAgIkB0eXBlcy9ub2RlIjogIjI1LjIuMCIsCiAgICAidHN4IjogIjQuMjEuMCIsCiAgICAidHlwZXNjcmlwdCI6ICI1LjguMiIsCiAgICAidml0ZSI6ICI3LjMuMSIsCiAgICAidml0ZS1wbHVnaW4tZHRzIjogIjQuNS40IiwKICAgICJ2aXRlc3QiOiAiMy4yLjQiLAogICAgInZzY29kZS1qc29ucnBjIjogIl44LjIuMSIKICB9LAogICJkZXBlbmRlbmNpZXMiOiB7CiAgICAiQGdpdGh1Yi9jb3BpbG90LXNkayI6ICJeMC4xLjIxIgogIH0sCiAgImJ1Z3MiOiB7CiAgICAidXJsIjogImh0dHBzOi8vZ2l0aHViLmNvbS9yYXBoYWVscG9yL2thdHQvaXNzdWVzIgogIH0sCiAgImhvbWVwYWdlIjogImh0dHBzOi8vZ2l0aHViLmNvbS9yYXBoYWVscG9yL2thdHQiCn0K", import.meta.url);
-let C;
-function ct() {
-  if (C !== void 0)
-    return C;
-  try {
-    const t = S.protocol === "data:" ? rt(S) : M(x(S), "utf8"), e = JSON.parse(t);
-    C = typeof e.version == "string" ? e.version : "unknown";
-  } catch {
-    C = "unknown";
-  }
-  return C;
-}
-function rt(t) {
-  const e = t.pathname.indexOf(",");
-  if (e < 0)
-    throw new Error("Invalid data URL.");
-  const n = t.pathname.slice(0, e), o = t.pathname.slice(e + 1);
-  return n.includes(";base64") ? Buffer.from(o, "base64").toString("utf8") : decodeURIComponent(o);
-}
-function lt() {
-  const t = " ██╗  ██╗ █████╗ ████████╗████████╗", e = " ██║ ██╔╝██╔══██╗╚══██╔══╝╚══██╔══╝", n = " █████╔╝ ███████║   ██║      ██║", o = " ██╔═██╗ ██╔══██║   ██║      ██║", a = " ██║  ██╗██║  ██║   ██║      ██║", r = " ╚═╝  ╚═╝╚═╝  ╚═╝   ╚═╝      ╚═╝", l = `v${ct()}`, g = Math.max(
-    0,
-    Math.floor((t.length - l.length) / 2)
-  ), I = `${" ".repeat(g)}${l}`;
-  console.log(`
-${f(t)}
-${f(e)}
-${f(n)}
-${w(o)}
-${w(a)}
-${ot(r)}
-${f(I)}
-`);
-}
-let Z = !1;
-function ut(t) {
-  Z = t;
-}
-function Zt() {
-  return Z;
-}
-function gt(t) {
-  const e = String(t.getHours()).padStart(2, "0"), n = String(t.getMinutes()).padStart(2, "0"), o = String(t.getSeconds()).padStart(2, "0");
-  return `${e}:${n}:${o}`;
-}
-async function Ft() {
-  const t = process.argv.slice(2), e = t.includes("--update-snapshots") || t.includes("-u");
-  ut(e), lt();
-  const n = /* @__PURE__ */ new Date();
-  it(), D(), z();
-  const o = await v(process.cwd());
-  if (o.length === 0)
-    return console.log("No .eval.js or .eval.ts files found."), 1;
-  const r = (await Promise.allSettled(
-    o.map(
-      (i) => at.run(
-        { evalFile: i },
-        () => import(y(i).href)
-      )
-    )
-  )).map((i, u) => ({ result: i, file: o[u] })).filter(({ result: i }) => i.status === "rejected");
-  if (r.length > 0) {
-    for (const i of r) {
-      const u = i.result.status === "rejected" ? i.result.reason : void 0;
-      console.error(`Error executing ${i.file}: ${String(u)}`);
-    }
-    return 1;
-  }
-  const g = (await _()).filter(
-    (i) => i.status === "rejected"
-  );
-  if (g.length > 0) {
-    for (const i of g)
-      i.status === "rejected" && console.error(`Error executing async test: ${String(i.reason)}`);
-    return 1;
-  }
-  const I = E();
-  if (I.length > 0) {
-    console.error("❌ Failed tests:");
-    for (const [i, u] of I.entries()) {
-      const b = [u.describePath, u.itPath].filter((T) => T.length > 0).join(" > "), N = b.length > 0 ? `${b}: ` : "";
-      console.error(`${i + 1}. ${N}${u.message}`);
-    }
-    return 1;
-  }
-  const d = P(), F = Date.now() - n.getTime();
-  return console.log(
-    [
-      "---",
-      `${c("Files")}  ${o.length} passed`,
-      `${c("Evals")}  ${d} passed`,
-      `${c("Start at")}  ${gt(n)}`,
-      `${c("Duration")}  ${F}ms`
-    ].join(`
-`)
-  ), 0;
-}
-export {
-  jt as a,
-  wt as b,
-  ht as c,
-  bt as d,
-  St as e,
-  At as f,
-  Jt as g,
-  Lt as h,
-  at as i,
-  vt as j,
-  Q as k,
-  Bt as l,
-  Y as m,
-  Zt as n,
-  Ft as o,
-  kt as p,
-  mt as r,
-  $t as s
-};