eminiar 0.9.1 → 0.10.1

package/dist/server.js

@@ -116,7 +116,7 @@ var require_code = __commonJS({
     }
     exports._ = _;
     var plus = new _Code("+");
-    function str2(strs, ...args) {
+    function str3(strs, ...args) {
       const expr = [safeStringify(strs[0])];
       let i = 0;
       while (i < args.length) {
@@ -127,7 +127,7 @@ var require_code = __commonJS({
       optimize(expr);
       return new _Code(expr);
     }
-    exports.str = str2;
+    exports.str = str3;
     function addCodeArg(code, arg) {
       if (arg instanceof _Code)
         code.push(...arg._items);
@@ -170,7 +170,7 @@ var require_code = __commonJS({
       return;
     }
     function strConcat(c1, c2) {
-      return c2.emptyStr() ? c1 : c1.emptyStr() ? c2 : str2`${c1}${c2}`;
+      return c2.emptyStr() ? c1 : c1.emptyStr() ? c2 : str3`${c1}${c2}`;
     }
     exports.strConcat = strConcat;
     function interpolate(x) {
@@ -1135,22 +1135,22 @@ var require_util = __commonJS({
       return (0, codegen_1._)`${topSchemaRef}${schemaPath}${(0, codegen_1.getProperty)(keyword)}`;
     }
     exports.schemaRefOrVal = schemaRefOrVal;
-    function unescapeFragment(str2) {
-      return unescapeJsonPointer(decodeURIComponent(str2));
+    function unescapeFragment(str3) {
+      return unescapeJsonPointer(decodeURIComponent(str3));
     }
     exports.unescapeFragment = unescapeFragment;
-    function escapeFragment(str2) {
-      return encodeURIComponent(escapeJsonPointer(str2));
+    function escapeFragment(str3) {
+      return encodeURIComponent(escapeJsonPointer(str3));
     }
     exports.escapeFragment = escapeFragment;
-    function escapeJsonPointer(str2) {
-      if (typeof str2 == "number")
-        return `${str2}`;
-      return str2.replace(/~/g, "~0").replace(/\//g, "~1");
+    function escapeJsonPointer(str3) {
+      if (typeof str3 == "number")
+        return `${str3}`;
+      return str3.replace(/~/g, "~0").replace(/\//g, "~1");
     }
     exports.escapeJsonPointer = escapeJsonPointer;
-    function unescapeJsonPointer(str2) {
-      return str2.replace(/~1/g, "/").replace(/~0/g, "~");
+    function unescapeJsonPointer(str3) {
+      return str3.replace(/~1/g, "/").replace(/~0/g, "~");
     }
     exports.unescapeJsonPointer = unescapeJsonPointer;
     function eachItem(xs, f) {
@@ -2187,8 +2187,8 @@ var require_json_schema_traverse = __commonJS({
         post(schema, jsonPtr, rootSchema, parentJsonPtr, parentKeyword, parentSchema, keyIndex);
       }
     }
-    function escapeJsonPtr(str2) {
-      return str2.replace(/~/g, "~0").replace(/\//g, "~1");
+    function escapeJsonPtr(str3) {
+      return str3.replace(/~/g, "~0").replace(/\//g, "~1");
     }
   }
 });
@@ -3019,7 +3019,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve8.call(this, root, ref);
+      let _sch = resolve9.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
         const { schemaId } = this.opts;
@@ -3046,7 +3046,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve8(root, ref) {
+    function resolve9(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -3291,10 +3291,10 @@ var require_utils = __commonJS({
         isIPV6: true
       };
     }
-    function findToken(str2, token) {
+    function findToken(str3, token) {
       let ind = 0;
-      for (let i = 0; i < str2.length; i++) {
-        if (str2[i] === token) ind++;
+      for (let i = 0; i < str3.length; i++) {
+        if (str3[i] === token) ind++;
       }
       return ind;
     }
@@ -3879,7 +3879,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve8(baseURI, relativeURI, options) {
+    function resolve9(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const {
         parsed: baseParsed,
@@ -4248,7 +4248,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize7,
-      resolve: resolve8,
+      resolve: resolve9,
       resolveComponent,
       equal,
       serialize,
@@ -4312,7 +4312,7 @@ var require_core = __commonJS({
     var util_1 = require_util();
     var $dataRefSchema = require_data();
     var uri_1 = require_uri();
-    var defaultRegExp = (str2, flags) => new RegExp(str2, flags);
+    var defaultRegExp = (str3, flags) => new RegExp(str3, flags);
     defaultRegExp.code = "new RegExp";
     var META_IGNORE_OPTIONS = ["removeAdditional", "useDefaults", "coerceTypes"];
     var EXT_SCOPE_NAMES = /* @__PURE__ */ new Set([
@@ -5113,16 +5113,16 @@ var require_ucs2length = __commonJS({
     "use strict";
     init_esm_shims();
     Object.defineProperty(exports, "__esModule", { value: true });
-    function ucs2length(str2) {
-      const len = str2.length;
+    function ucs2length(str3) {
+      const len = str3.length;
       let length = 0;
       let pos = 0;
       let value;
       while (pos < len) {
         length++;
-        value = str2.charCodeAt(pos++);
+        value = str3.charCodeAt(pos++);
         if (value >= 55296 && value <= 56319 && pos < len) {
-          value = str2.charCodeAt(pos);
+          value = str3.charCodeAt(pos);
           if ((value & 64512) === 56320)
             pos++;
         }
@@ -7040,8 +7040,8 @@ var require_formats = __commonJS({
     }
     var DATE = /^(\d\d\d\d)-(\d\d)-(\d\d)$/;
     var DAYS = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
-    function date5(str2) {
-      const matches2 = DATE.exec(str2);
+    function date5(str3) {
+      const matches2 = DATE.exec(str3);
       if (!matches2)
         return false;
       const year = +matches2[1];
@@ -7060,8 +7060,8 @@ var require_formats = __commonJS({
     }
     var TIME = /^(\d\d):(\d\d):(\d\d(?:\.\d+)?)(z|([+-])(\d\d)(?::?(\d\d))?)?$/i;
     function getTime(strictTimeZone) {
-      return function time3(str2) {
-        const matches2 = TIME.exec(str2);
+      return function time3(str3) {
+        const matches2 = TIME.exec(str3);
         if (!matches2)
           return false;
         const hr = +matches2[1];
@@ -7107,9 +7107,9 @@ var require_formats = __commonJS({
     var DATE_TIME_SEPARATOR = /t|\s/i;
     function getDateTime(strictTimeZone) {
       const time3 = getTime(strictTimeZone);
-      return function date_time(str2) {
-        const dateTime = str2.split(DATE_TIME_SEPARATOR);
-        return dateTime.length === 2 && date5(dateTime[0]) && time3(dateTime[1]);
+      return function date_time(str3) {
+        const dateTime2 = str3.split(DATE_TIME_SEPARATOR);
+        return dateTime2.length === 2 && date5(dateTime2[0]) && time3(dateTime2[1]);
       };
     }
     function compareDateTime(dt1, dt2) {
@@ -7133,13 +7133,13 @@ var require_formats = __commonJS({
     }
     var NOT_URI_FRAGMENT = /\/|:/;
     var URI = /^(?:[a-z][a-z0-9+\-.]*:)(?:\/?\/(?:(?:[a-z0-9\-._~!$&'()*+,;=:]|%[0-9a-f]{2})*@)?(?:\[(?:(?:(?:(?:[0-9a-f]{1,4}:){6}|::(?:[0-9a-f]{1,4}:){5}|(?:[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){4}|(?:(?:[0-9a-f]{1,4}:){0,1}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){3}|(?:(?:[0-9a-f]{1,4}:){0,2}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){2}|(?:(?:[0-9a-f]{1,4}:){0,3}[0-9a-f]{1,4})?::[0-9a-f]{1,4}:|(?:(?:[0-9a-f]{1,4}:){0,4}[0-9a-f]{1,4})?::)(?:[0-9a-f]{1,4}:[0-9a-f]{1,4}|(?:(?:25[0-5]|2[0-4]\d|[01]?\d\d?)\.){3}(?:25[0-5]|2[0-4]\d|[01]?\d\d?))|(?:(?:[0-9a-f]{1,4}:){0,5}[0-9a-f]{1,4})?::[0-9a-f]{1,4}|(?:(?:[0-9a-f]{1,4}:){0,6}[0-9a-f]{1,4})?::)|[Vv][0-9a-f]+\.[a-z0-9\-._~!$&'()*+,;=:]+)\]|(?:(?:25[0-5]|2[0-4]\d|[01]?\d\d?)\.){3}(?:25[0-5]|2[0-4]\d|[01]?\d\d?)|(?:[a-z0-9\-._~!$&'()*+,;=]|%[0-9a-f]{2})*)(?::\d*)?(?:\/(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*|\/(?:(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\/(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)?|(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\/(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)(?:\?(?:[a-z0-9\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?(?:#(?:[a-z0-9\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?$/i;
-    function uri(str2) {
-      return NOT_URI_FRAGMENT.test(str2) && URI.test(str2);
+    function uri(str3) {
+      return NOT_URI_FRAGMENT.test(str3) && URI.test(str3);
     }
     var BYTE = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/gm;
-    function byte(str2) {
+    function byte(str3) {
       BYTE.lastIndex = 0;
-      return BYTE.test(str2);
+      return BYTE.test(str3);
     }
     var MIN_INT32 = -(2 ** 31);
     var MAX_INT32 = 2 ** 31 - 1;
@@ -7153,11 +7153,11 @@ var require_formats = __commonJS({
       return true;
     }
     var Z_ANCHOR = /[^\\]\\Z/;
-    function regex(str2) {
-      if (Z_ANCHOR.test(str2))
+    function regex(str3) {
+      if (Z_ANCHOR.test(str3))
         return false;
       try {
-        new RegExp(str2);
+        new RegExp(str3);
         return true;
       } catch (e) {
         return false;
@@ -7644,14 +7644,14 @@ var require_is_extglob = __commonJS({
   "node_modules/is-extglob/index.js"(exports, module) {
     "use strict";
     init_esm_shims();
-    module.exports = function isExtglob(str2) {
-      if (typeof str2 !== "string" || str2 === "") {
+    module.exports = function isExtglob(str3) {
+      if (typeof str3 !== "string" || str3 === "") {
         return false;
       }
       var match;
-      while (match = /(\\).|([@?!+*]\(.*\))/g.exec(str2)) {
+      while (match = /(\\).|([@?!+*]\(.*\))/g.exec(str3)) {
         if (match[2]) return true;
-        str2 = str2.slice(match.index + match[0].length);
+        str3 = str3.slice(match.index + match[0].length);
       }
       return false;
     };
@@ -7665,8 +7665,8 @@ var require_is_glob = __commonJS({
     init_esm_shims();
     var isExtglob = require_is_extglob();
     var chars = { "{": "}", "(": ")", "[": "]" };
-    var strictCheck = function(str2) {
-      if (str2[0] === "!") {
+    var strictCheck = function(str3) {
+      if (str3[0] === "!") {
         return true;
       }
       var index = 0;
@@ -7675,70 +7675,70 @@ var require_is_glob = __commonJS({
       var closeCurlyIndex = -2;
       var closeParenIndex = -2;
       var backSlashIndex = -2;
-      while (index < str2.length) {
-        if (str2[index] === "*") {
+      while (index < str3.length) {
+        if (str3[index] === "*") {
           return true;
         }
-        if (str2[index + 1] === "?" && /[\].+)]/.test(str2[index])) {
+        if (str3[index + 1] === "?" && /[\].+)]/.test(str3[index])) {
           return true;
         }
-        if (closeSquareIndex !== -1 && str2[index] === "[" && str2[index + 1] !== "]") {
+        if (closeSquareIndex !== -1 && str3[index] === "[" && str3[index + 1] !== "]") {
           if (closeSquareIndex < index) {
-            closeSquareIndex = str2.indexOf("]", index);
+            closeSquareIndex = str3.indexOf("]", index);
           }
           if (closeSquareIndex > index) {
             if (backSlashIndex === -1 || backSlashIndex > closeSquareIndex) {
               return true;
             }
-            backSlashIndex = str2.indexOf("\\", index);
+            backSlashIndex = str3.indexOf("\\", index);
             if (backSlashIndex === -1 || backSlashIndex > closeSquareIndex) {
               return true;
             }
           }
         }
-        if (closeCurlyIndex !== -1 && str2[index] === "{" && str2[index + 1] !== "}") {
-          closeCurlyIndex = str2.indexOf("}", index);
+        if (closeCurlyIndex !== -1 && str3[index] === "{" && str3[index + 1] !== "}") {
+          closeCurlyIndex = str3.indexOf("}", index);
           if (closeCurlyIndex > index) {
-            backSlashIndex = str2.indexOf("\\", index);
+            backSlashIndex = str3.indexOf("\\", index);
             if (backSlashIndex === -1 || backSlashIndex > closeCurlyIndex) {
               return true;
             }
           }
         }
-        if (closeParenIndex !== -1 && str2[index] === "(" && str2[index + 1] === "?" && /[:!=]/.test(str2[index + 2]) && str2[index + 3] !== ")") {
-          closeParenIndex = str2.indexOf(")", index);
+        if (closeParenIndex !== -1 && str3[index] === "(" && str3[index + 1] === "?" && /[:!=]/.test(str3[index + 2]) && str3[index + 3] !== ")") {
+          closeParenIndex = str3.indexOf(")", index);
           if (closeParenIndex > index) {
-            backSlashIndex = str2.indexOf("\\", index);
+            backSlashIndex = str3.indexOf("\\", index);
             if (backSlashIndex === -1 || backSlashIndex > closeParenIndex) {
               return true;
             }
           }
         }
-        if (pipeIndex !== -1 && str2[index] === "(" && str2[index + 1] !== "|") {
+        if (pipeIndex !== -1 && str3[index] === "(" && str3[index + 1] !== "|") {
           if (pipeIndex < index) {
-            pipeIndex = str2.indexOf("|", index);
+            pipeIndex = str3.indexOf("|", index);
           }
-          if (pipeIndex !== -1 && str2[pipeIndex + 1] !== ")") {
-            closeParenIndex = str2.indexOf(")", pipeIndex);
+          if (pipeIndex !== -1 && str3[pipeIndex + 1] !== ")") {
+            closeParenIndex = str3.indexOf(")", pipeIndex);
             if (closeParenIndex > pipeIndex) {
-              backSlashIndex = str2.indexOf("\\", pipeIndex);
+              backSlashIndex = str3.indexOf("\\", pipeIndex);
               if (backSlashIndex === -1 || backSlashIndex > closeParenIndex) {
                 return true;
               }
             }
           }
         }
-        if (str2[index] === "\\") {
-          var open3 = str2[index + 1];
+        if (str3[index] === "\\") {
+          var open3 = str3[index + 1];
           index += 2;
           var close = chars[open3];
           if (close) {
-            var n = str2.indexOf(close, index);
+            var n = str3.indexOf(close, index);
             if (n !== -1) {
               index = n + 1;
             }
           }
-          if (str2[index] === "!") {
+          if (str3[index] === "!") {
             return true;
           }
         } else {
@@ -7747,26 +7747,26 @@ var require_is_glob = __commonJS({
       }
       return false;
     };
-    var relaxedCheck = function(str2) {
-      if (str2[0] === "!") {
+    var relaxedCheck = function(str3) {
+      if (str3[0] === "!") {
         return true;
       }
       var index = 0;
-      while (index < str2.length) {
-        if (/[*?{}()[\]]/.test(str2[index])) {
+      while (index < str3.length) {
+        if (/[*?{}()[\]]/.test(str3[index])) {
           return true;
         }
-        if (str2[index] === "\\") {
-          var open3 = str2[index + 1];
+        if (str3[index] === "\\") {
+          var open3 = str3[index + 1];
           index += 2;
           var close = chars[open3];
           if (close) {
-            var n = str2.indexOf(close, index);
+            var n = str3.indexOf(close, index);
             if (n !== -1) {
               index = n + 1;
             }
           }
-          if (str2[index] === "!") {
+          if (str3[index] === "!") {
             return true;
           }
         } else {
@@ -7775,18 +7775,18 @@ var require_is_glob = __commonJS({
       }
       return false;
     };
-    module.exports = function isGlob(str2, options) {
-      if (typeof str2 !== "string" || str2 === "") {
+    module.exports = function isGlob(str3, options) {
+      if (typeof str3 !== "string" || str3 === "") {
         return false;
       }
-      if (isExtglob(str2)) {
+      if (isExtglob(str3)) {
         return true;
       }
       var check3 = strictCheck;
       if (options && options.strict === false) {
         check3 = relaxedCheck;
       }
-      return check3(str2);
+      return check3(str3);
     };
   }
 });
@@ -7804,19 +7804,19 @@ var require_glob_parent = __commonJS({
     var enclosure = /[\{\[].*[\}\]]$/;
     var globby = /(^|[^\\])([\{\[]|\([^\)]+$)/;
     var escaped = /\\([\!\*\?\|\[\]\(\)\{\}])/g;
-    module.exports = function globParent(str2, opts) {
+    module.exports = function globParent(str3, opts) {
       var options = Object.assign({ flipBackslashes: true }, opts);
-      if (options.flipBackslashes && isWin32 && str2.indexOf(slash) < 0) {
-        str2 = str2.replace(backslash, slash);
+      if (options.flipBackslashes && isWin32 && str3.indexOf(slash) < 0) {
+        str3 = str3.replace(backslash, slash);
       }
-      if (enclosure.test(str2)) {
-        str2 += slash;
+      if (enclosure.test(str3)) {
+        str3 += slash;
       }
-      str2 += "a";
+      str3 += "a";
       do {
-        str2 = pathPosixDirname(str2);
-      } while (isGlob(str2) || globby.test(str2));
-      return str2.replace(escaped, "$1");
+        str3 = pathPosixDirname(str3);
+      } while (isGlob(str3) || globby.test(str3));
+      return str3.replace(escaped, "$1");
     };
   }
 });
@@ -7826,12 +7826,12 @@ var require_utils2 = __commonJS({
   "node_modules/braces/lib/utils.js"(exports) {
     "use strict";
     init_esm_shims();
-    exports.isInteger = (num2) => {
-      if (typeof num2 === "number") {
-        return Number.isInteger(num2);
+    exports.isInteger = (num5) => {
+      if (typeof num5 === "number") {
+        return Number.isInteger(num5);
       }
-      if (typeof num2 === "string" && num2.trim() !== "") {
-        return Number.isInteger(Number(num2));
+      if (typeof num5 === "string" && num5.trim() !== "") {
+        return Number.isInteger(Number(num5));
       }
       return false;
     };
@@ -7941,12 +7941,12 @@ var require_is_number = __commonJS({
   "node_modules/is-number/index.js"(exports, module) {
     "use strict";
     init_esm_shims();
-    module.exports = function(num2) {
-      if (typeof num2 === "number") {
-        return num2 - num2 === 0;
+    module.exports = function(num5) {
+      if (typeof num5 === "number") {
+        return num5 - num5 === 0;
       }
-      if (typeof num2 === "string" && num2.trim() !== "") {
-        return Number.isFinite ? Number.isFinite(+num2) : isFinite(+num2);
+      if (typeof num5 === "string" && num5.trim() !== "") {
+        return Number.isFinite ? Number.isFinite(+num5) : isFinite(+num5);
       }
       return false;
     };
@@ -8070,7 +8070,7 @@ var require_to_regex_range = __commonJS({
       }
       return { pattern: pattern2, count: [count], digits };
     }
-    function splitToPatterns(min, max, tok, options) {
+    function splitToPatterns(min, max, tok2, options) {
       let ranges = splitToRanges(min, max);
       let tokens = [];
       let start = min;
@@ -8079,7 +8079,7 @@ var require_to_regex_range = __commonJS({
         let max2 = ranges[i];
         let obj = rangeToPattern(String(start), String(max2), options);
         let zeros = "";
-        if (!tok.isPadded && prev && prev.pattern === obj.pattern) {
+        if (!tok2.isPadded && prev && prev.pattern === obj.pattern) {
           if (prev.count.length > 1) {
             prev.count.pop();
           }
@@ -8088,8 +8088,8 @@ var require_to_regex_range = __commonJS({
           start = max2 + 1;
           continue;
         }
-        if (tok.isPadded) {
-          zeros = padZeros(max2, tok, options);
+        if (tok2.isPadded) {
+          zeros = padZeros(max2, tok2, options);
         }
         obj.string = zeros + obj.pattern + toQuantifier(obj.count);
         tokens.push(obj);
@@ -8138,14 +8138,14 @@ var require_to_regex_range = __commonJS({
     function toCharacterClass(a, b, options) {
       return `[${a}${b - a === 1 ? "" : "-"}${b}]`;
     }
-    function hasPadding(str2) {
-      return /^-?(0+)\d/.test(str2);
+    function hasPadding(str3) {
+      return /^-?(0+)\d/.test(str3);
     }
-    function padZeros(value, tok, options) {
-      if (!tok.isPadded) {
+    function padZeros(value, tok2, options) {
+      if (!tok2.isPadded) {
         return value;
       }
-      let diff = Math.abs(tok.maxLen - String(value).length);
+      let diff = Math.abs(tok2.maxLen - String(value).length);
       let relax = options.relaxZeros !== false;
       switch (diff) {
         case 0:
@@ -8179,7 +8179,7 @@ var require_fill_range = __commonJS({
     var isValidValue = (value) => {
       return typeof value === "number" || typeof value === "string" && value !== "";
     };
-    var isNumber = (num2) => Number.isInteger(+num2);
+    var isNumber = (num5) => Number.isInteger(+num5);
     var zeros = (input2) => {
       let value = `${input2}`;
       let index = -1;
@@ -8289,7 +8289,7 @@ var require_fill_range = __commonJS({
         return toRange(toMaxLen(start, maxLen), toMaxLen(end, maxLen), true, options);
       }
       let parts = { negatives: [], positives: [] };
-      let push = (num2) => parts[num2 < 0 ? "negatives" : "positives"].push(Math.abs(num2));
+      let push = (num5) => parts[num5 < 0 ? "negatives" : "positives"].push(Math.abs(num5));
       let range = [];
       let index = 0;
       while (descending ? a >= b : a <= b) {
@@ -9129,12 +9129,12 @@ var require_utils3 = __commonJS({
       REGEX_SPECIAL_CHARS_GLOBAL
     } = require_constants2();
     exports.isObject = (val) => val !== null && typeof val === "object" && !Array.isArray(val);
-    exports.hasRegexChars = (str2) => REGEX_SPECIAL_CHARS.test(str2);
-    exports.isRegexChar = (str2) => str2.length === 1 && exports.hasRegexChars(str2);
-    exports.escapeRegex = (str2) => str2.replace(REGEX_SPECIAL_CHARS_GLOBAL, "\\$1");
-    exports.toPosixSlashes = (str2) => str2.replace(REGEX_BACKSLASH, "/");
-    exports.removeBackslashes = (str2) => {
-      return str2.replace(REGEX_REMOVE_BACKSLASH, (match) => {
+    exports.hasRegexChars = (str3) => REGEX_SPECIAL_CHARS.test(str3);
+    exports.isRegexChar = (str3) => str3.length === 1 && exports.hasRegexChars(str3);
+    exports.escapeRegex = (str3) => str3.replace(REGEX_SPECIAL_CHARS_GLOBAL, "\\$1");
+    exports.toPosixSlashes = (str3) => str3.replace(REGEX_BACKSLASH, "/");
+    exports.removeBackslashes = (str3) => {
+      return str3.replace(REGEX_REMOVE_BACKSLASH, (match) => {
         return match === "\\" ? "" : match;
       });
     };
@@ -9230,7 +9230,7 @@ var require_scan = __commonJS({
       const slashes = [];
       const tokens = [];
       const parts = [];
-      let str2 = input2;
+      let str3 = input2;
       let index = -1;
       let start = 0;
       let lastIndex = 0;
@@ -9249,10 +9249,10 @@ var require_scan = __commonJS({
       let code;
       let token = { value: "", depth: 0, isGlob: false };
       const eos = () => index >= length;
-      const peek = () => str2.charCodeAt(index + 1);
+      const peek = () => str3.charCodeAt(index + 1);
       const advance = () => {
         prev = code;
-        return str2.charCodeAt(++index);
+        return str3.charCodeAt(++index);
       };
       while (index < length) {
         code = advance();
@@ -9420,24 +9420,24 @@ var require_scan = __commonJS({
         isExtglob = false;
         isGlob = false;
       }
-      let base = str2;
+      let base = str3;
       let prefix = "";
       let glob2 = "";
       if (start > 0) {
-        prefix = str2.slice(0, start);
-        str2 = str2.slice(start);
+        prefix = str3.slice(0, start);
+        str3 = str3.slice(start);
         lastIndex -= start;
       }
       if (base && isGlob === true && lastIndex > 0) {
-        base = str2.slice(0, lastIndex);
-        glob2 = str2.slice(lastIndex);
+        base = str3.slice(0, lastIndex);
+        glob2 = str3.slice(lastIndex);
       } else if (isGlob === true) {
         base = "";
-        glob2 = str2;
+        glob2 = str3;
       } else {
-        base = str2;
+        base = str3;
       }
-      if (base && base !== "" && base !== "/" && base !== str2) {
+      if (base && base !== "" && base !== "/" && base !== str3) {
         if (isPathSeparator(base.charCodeAt(base.length - 1))) {
           base = base.slice(0, -1);
         }
@@ -9816,9 +9816,9 @@ var require_parse2 = __commonJS({
       const peek = state.peek = (n = 1) => input2[state.index + n];
       const advance = state.advance = () => input2[++state.index] || "";
       const remaining = () => input2.slice(state.index + 1);
-      const consume = (value2 = "", num2 = 0) => {
+      const consume = (value2 = "", num5 = 0) => {
         state.consumed += value2;
-        state.index += num2;
+        state.index += num5;
       };
       const append = (token) => {
         state.output += token.output != null ? token.output : token.value;
@@ -9846,11 +9846,11 @@ var require_parse2 = __commonJS({
         state[type]--;
         stack.pop();
       };
-      const push = (tok) => {
+      const push = (tok2) => {
         if (prev.type === "globstar") {
-          const isBrace = state.braces > 0 && (tok.type === "comma" || tok.type === "brace");
-          const isExtglob = tok.extglob === true || extglobs.length && (tok.type === "pipe" || tok.type === "paren");
-          if (tok.type !== "slash" && tok.type !== "paren" && !isBrace && !isExtglob) {
+          const isBrace = state.braces > 0 && (tok2.type === "comma" || tok2.type === "brace");
+          const isExtglob = tok2.extglob === true || extglobs.length && (tok2.type === "pipe" || tok2.type === "paren");
+          if (tok2.type !== "slash" && tok2.type !== "paren" && !isBrace && !isExtglob) {
             state.output = state.output.slice(0, -prev.output.length);
             prev.type = "star";
             prev.value = "*";
@@ -9858,18 +9858,18 @@ var require_parse2 = __commonJS({
             state.output += prev.output;
           }
         }
-        if (extglobs.length && tok.type !== "paren") {
-          extglobs[extglobs.length - 1].inner += tok.value;
+        if (extglobs.length && tok2.type !== "paren") {
+          extglobs[extglobs.length - 1].inner += tok2.value;
         }
-        if (tok.value || tok.output) append(tok);
-        if (prev && prev.type === "text" && tok.type === "text") {
-          prev.value += tok.value;
-          prev.output = (prev.output || "") + tok.value;
+        if (tok2.value || tok2.output) append(tok2);
+        if (prev && prev.type === "text" && tok2.type === "text") {
+          prev.value += tok2.value;
+          prev.output = (prev.output || "") + tok2.value;
           return;
         }
-        tok.prev = prev;
-        tokens.push(tok);
-        prev = tok;
+        tok2.prev = prev;
+        tokens.push(tok2);
+        prev = tok2;
       };
       const extglobOpen = (type, value2) => {
         const token = { ...EXTGLOB_CHARS[value2], conditions: 1, inner: "" };
@@ -10473,8 +10473,8 @@ var require_parse2 = __commonJS({
         if (opts2.noglobstar === true) return star;
         return `(${capture}(?:(?!${START_ANCHOR}${opts2.dot ? DOTS_SLASH : DOT_LITERAL}).)*?)`;
       };
-      const create = (str2) => {
-        switch (str2) {
+      const create = (str3) => {
+        switch (str3) {
           case "*":
             return `${nodot}${ONE_CHAR}${star}`;
           case ".*":
@@ -10492,7 +10492,7 @@ var require_parse2 = __commonJS({
           case "**/.*":
             return `(?:${nodot}${globstar(opts)}${SLASH_LITERAL})?${DOT_LITERAL}${ONE_CHAR}${star}`;
           default: {
-            const match = /^(.*?)\.(\w+)$/.exec(str2);
+            const match = /^(.*?)\.(\w+)$/.exec(str3);
             if (!match) return;
             const source2 = create(match[1]);
             if (!source2) return;
@@ -10525,9 +10525,9 @@ var require_picomatch = __commonJS({
     var picomatch = (glob2, options, returnState = false) => {
       if (Array.isArray(glob2)) {
         const fns = glob2.map((input2) => picomatch(input2, options, returnState));
-        const arrayMatcher = (str2) => {
+        const arrayMatcher = (str3) => {
           for (const isMatch of fns) {
-            const state2 = isMatch(str2);
+            const state2 = isMatch(str3);
             if (state2) return state2;
           }
           return false;
@@ -10603,7 +10603,7 @@ var require_picomatch = __commonJS({
       const regex = glob2 instanceof RegExp ? glob2 : picomatch.makeRe(glob2, options);
       return regex.test(path3.basename(input2));
     };
-    picomatch.isMatch = (str2, patterns, options) => picomatch(patterns, options)(str2);
+    picomatch.isMatch = (str3, patterns, options) => picomatch(patterns, options)(str3);
     picomatch.parse = (pattern2, options) => {
       if (Array.isArray(pattern2)) return pattern2.map((p) => picomatch.parse(p, options));
       return parse3(pattern2, { ...options, fastpaths: false });
@@ -10719,7 +10719,7 @@ var require_micromatch = __commonJS({
     };
     micromatch.match = micromatch;
     micromatch.matcher = (pattern2, options) => picomatch(pattern2, options);
-    micromatch.isMatch = (str2, patterns, options) => picomatch(patterns, options)(str2);
+    micromatch.isMatch = (str3, patterns, options) => picomatch(patterns, options)(str3);
     micromatch.any = micromatch.isMatch;
     micromatch.not = (list2, patterns, options = {}) => {
       patterns = [].concat(patterns).map(String);
@@ -10737,22 +10737,22 @@ var require_micromatch = __commonJS({
       }
       return [...result];
     };
-    micromatch.contains = (str2, pattern2, options) => {
-      if (typeof str2 !== "string") {
-        throw new TypeError(`Expected a string: "${util2.inspect(str2)}"`);
+    micromatch.contains = (str3, pattern2, options) => {
+      if (typeof str3 !== "string") {
+        throw new TypeError(`Expected a string: "${util2.inspect(str3)}"`);
       }
       if (Array.isArray(pattern2)) {
-        return pattern2.some((p) => micromatch.contains(str2, p, options));
+        return pattern2.some((p) => micromatch.contains(str3, p, options));
       }
       if (typeof pattern2 === "string") {
-        if (isEmptyString(str2) || isEmptyString(pattern2)) {
+        if (isEmptyString(str3) || isEmptyString(pattern2)) {
           return false;
         }
-        if (str2.includes(pattern2) || str2.startsWith("./") && str2.slice(2).includes(pattern2)) {
+        if (str3.includes(pattern2) || str3.startsWith("./") && str3.slice(2).includes(pattern2)) {
           return true;
         }
       }
-      return micromatch.isMatch(str2, pattern2, { ...options, contains: true });
+      return micromatch.isMatch(str3, pattern2, { ...options, contains: true });
     };
     micromatch.matchKeys = (obj, patterns, options) => {
       if (!utils.isObject(obj)) {
@@ -10783,11 +10783,11 @@ var require_micromatch = __commonJS({
       }
       return true;
     };
-    micromatch.all = (str2, patterns, options) => {
-      if (typeof str2 !== "string") {
-        throw new TypeError(`Expected a string: "${util2.inspect(str2)}"`);
+    micromatch.all = (str3, patterns, options) => {
+      if (typeof str3 !== "string") {
+        throw new TypeError(`Expected a string: "${util2.inspect(str3)}"`);
       }
-      return [].concat(patterns).every((p) => picomatch(p, options)(str2));
+      return [].concat(patterns).every((p) => picomatch(p, options)(str3));
     };
     micromatch.capture = (glob2, input2, options) => {
       let posix2 = utils.isWindows(options);
@@ -10802,8 +10802,8 @@ var require_micromatch = __commonJS({
     micromatch.parse = (patterns, options) => {
       let res = [];
       for (let pattern2 of [].concat(patterns || [])) {
-        for (let str2 of braces(String(pattern2), options)) {
-          res.push(picomatch.parse(str2, options));
+        for (let str3 of braces(String(pattern2), options)) {
+          res.push(picomatch.parse(str3, options));
         }
       }
       return res;
@@ -10926,8 +10926,8 @@ var require_pattern2 = __commonJS({
     }
     exports.endsWithSlashGlobStar = endsWithSlashGlobStar;
     function isAffectDepthOfReadingPattern(pattern2) {
-      const basename2 = path3.basename(pattern2);
-      return endsWithSlashGlobStar(pattern2) || isStaticPattern(basename2);
+      const basename3 = path3.basename(pattern2);
+      return endsWithSlashGlobStar(pattern2) || isStaticPattern(basename3);
     }
     exports.isAffectDepthOfReadingPattern = isAffectDepthOfReadingPattern;
     function expandPatternsWithBraceExpansion(patterns) {
@@ -11411,11 +11411,11 @@ var require_out = __commonJS({
       async.read(path3, getSettings(optionsOrSettingsOrCallback), callback);
     }
     exports.stat = stat;
-    function statSync11(path3, optionsOrSettings) {
+    function statSync12(path3, optionsOrSettings) {
       const settings = getSettings(optionsOrSettings);
       return sync.read(path3, settings);
     }
-    exports.statSync = statSync11;
+    exports.statSync = statSync12;
     function getSettings(settingsOrOptions = {}) {
       if (settingsOrOptions instanceof settings_1.default) {
         return settingsOrOptions;
@@ -12096,41 +12096,41 @@ var require_queue = __commonJS({
       queue.drained = drained;
       return queue;
       function push(value) {
-        var p = new Promise(function(resolve8, reject) {
+        var p = new Promise(function(resolve9, reject) {
           pushCb(value, function(err, result) {
             if (err) {
               reject(err);
               return;
             }
-            resolve8(result);
+            resolve9(result);
           });
         });
         p.catch(noop);
         return p;
       }
       function unshift(value) {
-        var p = new Promise(function(resolve8, reject) {
+        var p = new Promise(function(resolve9, reject) {
           unshiftCb(value, function(err, result) {
             if (err) {
               reject(err);
               return;
             }
-            resolve8(result);
+            resolve9(result);
           });
         });
         p.catch(noop);
         return p;
       }
       function drained() {
-        var p = new Promise(function(resolve8) {
+        var p = new Promise(function(resolve9) {
           process.nextTick(function() {
             if (queue.idle()) {
-              resolve8();
+              resolve9();
             } else {
               var previousDrain = queue.drain;
               queue.drain = function() {
                 if (typeof previousDrain === "function") previousDrain();
-                resolve8();
+                resolve9();
                 queue.drain = previousDrain;
               };
             }
@@ -12627,9 +12627,9 @@ var require_stream3 = __commonJS({
         });
       }
       _getStat(filepath) {
-        return new Promise((resolve8, reject) => {
+        return new Promise((resolve9, reject) => {
           this._stat(filepath, this._fsStatSettings, (error62, stats) => {
-            return error62 === null ? resolve8(stats) : reject(error62);
+            return error62 === null ? resolve9(stats) : reject(error62);
           });
         });
       }
@@ -12654,10 +12654,10 @@ var require_async5 = __commonJS({
         this._readerStream = new stream_1.default(this._settings);
       }
       dynamic(root, options) {
-        return new Promise((resolve8, reject) => {
+        return new Promise((resolve9, reject) => {
           this._walkAsync(root, options, (error62, entries) => {
             if (error62 === null) {
-              resolve8(entries);
+              resolve9(entries);
             } else {
               reject(error62);
             }
@@ -12667,10 +12667,10 @@ var require_async5 = __commonJS({
       async static(patterns, options) {
         const entries = [];
         const stream = this._readerStream.static(patterns, options);
-        return new Promise((resolve8, reject) => {
+        return new Promise((resolve9, reject) => {
           stream.once("error", reject);
           stream.on("data", (entry) => entries.push(entry));
-          stream.once("end", () => resolve8(entries));
+          stream.once("end", () => resolve9(entries));
         });
       }
     };
@@ -13518,7 +13518,7 @@ function chunkMarkdown(text2, baseTitle, opts = DEFAULT_CHUNKER) {
     if (/^\s*(```|~~~)/.test(line)) inFence = !inFence;
     const m = !inFence && /^(#{1,6})\s+(.+?)\s*#*\s*$/.exec(line);
     if (m) {
-      if (current.lines.length) sections.push(current);
+      sections.push(current);
       const level = m[1].length;
       while (stack.length && stack[stack.length - 1].level >= level) stack.pop();
       stack.push({ level, text: m[2] });
@@ -13527,14 +13527,23 @@ function chunkMarkdown(text2, baseTitle, opts = DEFAULT_CHUNKER) {
     }
     current.lines.push(line);
   });
-  if (current.lines.length) sections.push(current);
+  sections.push(current);
   const out = [];
-  for (const s of sections) {
+  sections.forEach((s, k) => {
     const title = s.path.length ? `${baseTitle} > ${s.path.join(" > ")}` : baseTitle;
     const body = s.lines.join("\n");
+    if (!body.trim()) {
+      const next = sections[k + 1];
+      const isParent = next !== void 0 && next.path.length > s.path.length && s.path.every((p, j) => next.path[j] === p);
+      if (s.path.length && !isParent) {
+        const heading = s.path[s.path.length - 1];
+        out.push({ title, body: heading, startLine: s.startLine, endLine: s.startLine });
+      }
+      return;
+    }
     if (body.length <= opts.maxChars) {
       out.push({ title, body, startLine: s.startLine, endLine: s.startLine + s.lines.length - 1 });
-      continue;
+      return;
     }
     let fence2 = false;
     const fenceState = s.lines.map((l) => {
@@ -13550,7 +13559,7 @@ function chunkMarkdown(text2, baseTitle, opts = DEFAULT_CHUNKER) {
         s.startLine - 1
       )
     );
-  }
+  });
   return out;
 }
 var init_markdown = __esm({
@@ -16953,7 +16962,20 @@ import { readFileSync as readFileSync6, statSync as statSync4 } from "fs";
 import { relative as relative5, resolve as resolve6 } from "path";
 function indexContent(db, input2) {
   const kind = input2.kind ?? (input2.contentType === "code" ? "code" : input2.contentType === "json" ? "json" : void 0);
-  const { chunks, kind: k } = input2.chunks ? { chunks: finalize2(input2.chunks, input2.contentType ?? "code"), kind: kind ?? "code" } : chunk(input2.content, input2.title, kind, input2.uri);
+  const cut = input2.chunks ? { chunks: finalize2(input2.chunks, input2.contentType ?? "code"), kind: kind ?? "code" } : chunk(input2.content, input2.title, kind, input2.uri);
+  const k = cut.kind;
+  const fallback = cut.chunks.length === 0 && input2.content.trim().length > 0;
+  const chunks = fallback ? finalize2(
+    [
+      {
+        title: input2.title,
+        body: input2.content,
+        startLine: 1,
+        endLine: input2.content.split("\n").length
+      }
+    ],
+    kindToContentType(k)
+  ) : cut.chunks;
   const contentHash = hashText(input2.content);
   const existing = input2.uri ? db.findDocumentByUri(input2.uri) : void 0;
   if (existing && existing.content_hash === contentHash) {
@@ -16963,7 +16985,8 @@ function indexContent(db, input2) {
         created: false,
         chunks: chunks.length,
         chars: input2.content.length,
-        kind: k
+        kind: k,
+        fallback
       };
     }
     db.deleteDocument(existing.id);
@@ -16980,11 +17003,25 @@ function indexContent(db, input2) {
     },
     chunks
   );
-  return { documentId: id, created, chunks: chunks.length, chars: input2.content.length, kind: k };
+  return {
+    documentId: id,
+    created,
+    chunks: chunks.length,
+    chars: input2.content.length,
+    kind: k,
+    fallback
+  };
 }
 function indexPath(db, root, target, opts = {}) {
   const abs = resolve6(root, target);
-  const summary = { files: 0, indexed: 0, unchanged: 0, skipped: [], chunks: 0 };
+  const summary = {
+    files: 0,
+    indexed: 0,
+    unchanged: 0,
+    skipped: [],
+    chunks: 0,
+    fallbacks: 0
+  };
   const st = statSync4(abs);
   const files = st.isDirectory() ? import_fast_glob.default.sync(opts.globs ?? ["**/*.md"], {
     cwd: abs,
@@ -17019,6 +17056,7 @@ function indexPath(db, root, target, opts = {}) {
       if (r.created) summary.indexed++;
       else summary.unchanged++;
       summary.chunks += r.chunks;
+      if (r.fallback) summary.fallbacks++;
     } catch (err) {
       summary.skipped.push({ path: rel, reason: err.message });
     }
@@ -18982,14 +19020,14 @@ function buildHistory(ctx, db, opts = {}) {
     };
   });
   const bySha = new Map(commits.map((c) => [c.sha, c]));
-  const resolve8 = (prefix) => {
+  const resolve9 = (prefix) => {
     if (bySha.has(prefix)) return bySha.get(prefix);
     for (const c of commits) if (c.sha.startsWith(prefix)) return c;
     return void 0;
   };
   for (const c of commits) {
     if (c.kind !== "revert" || !c.revertOf) continue;
-    const target = resolve8(c.revertOf);
+    const target = resolve9(c.revertOf);
     if (target) {
       target.revertedBy = c.sha;
       c.origins.push(target.sha);
@@ -24006,14 +24044,14 @@ function promiseAllObject(promisesObj) {
 }
 function randomString(length = 10) {
   const chars = "abcdefghijklmnopqrstuvwxyz";
-  let str2 = "";
+  let str3 = "";
   for (let i = 0; i < length; i++) {
-    str2 += chars[Math.floor(Math.random() * chars.length)];
+    str3 += chars[Math.floor(Math.random() * chars.length)];
   }
-  return str2;
+  return str3;
 }
-function esc(str2) {
-  return JSON.stringify(str2);
+function esc(str3) {
+  return JSON.stringify(str3);
 }
 function slugify(input2) {
   return input2.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_-]+/g, "-").replace(/^-+|-+$/g, "");
@@ -24127,8 +24165,8 @@ var primitiveTypes = /* @__PURE__ */ new Set([
   "symbol",
   "undefined"
 ]);
-function escapeRegex(str2) {
-  return str2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function escapeRegex(str3) {
+  return str3.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function clone(inst, def, params) {
   const cl = new inst._zod.constr(def ?? inst._zod.def);
@@ -24394,13 +24432,13 @@ function getSizableOrigin(input2) {
   return "unknown";
 }
 var highSurrogate = /[\uD800-\uDBFF]/;
-function codePointLength(str2) {
-  const units = str2.length;
-  if (!highSurrogate.test(str2))
+function codePointLength(str3) {
+  const units = str3.length;
+  if (!highSurrogate.test(str3))
     return units;
   let count = units;
   for (let i = 0; i < units - 1; i++) {
-    if ((str2.charCodeAt(i) & 64512) === 55296 && (str2.charCodeAt(i + 1) & 64512) === 56320) {
+    if ((str3.charCodeAt(i) & 64512) === 55296 && (str3.charCodeAt(i + 1) & 64512) === 56320) {
       count--;
       i++;
     }
@@ -25213,8 +25251,8 @@ function anchor(source) {
 }
 var date = /* @__PURE__ */ anchor(dateSource);
 function timeSource(args) {
-  const hhmm = `(?:[01]\\d|2[0-3]):[0-5]\\d`;
-  const regex = typeof args.precision === "number" ? args.precision === -1 ? `${hhmm}` : args.precision === 0 ? `${hhmm}:[0-5]\\d` : `${hhmm}:[0-5]\\d\\.\\d{${args.precision}}` : args.seconds ? `${hhmm}:[0-5]\\d(?:\\.\\d+)?` : `${hhmm}(?::[0-5]\\d(?:\\.\\d+)?)?`;
+  const hhmm2 = `(?:[01]\\d|2[0-3]):[0-5]\\d`;
+  const regex = typeof args.precision === "number" ? args.precision === -1 ? `${hhmm2}` : args.precision === 0 ? `${hhmm2}:[0-5]\\d` : `${hhmm2}:[0-5]\\d\\.\\d{${args.precision}}` : args.seconds ? `${hhmm2}:[0-5]\\d(?:\\.\\d+)?` : `${hhmm2}(?::[0-5]\\d(?:\\.\\d+)?)?`;
   return regex;
 }
 function time(args) {
@@ -28252,7 +28290,7 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve8) {
+function isRecursive(inst, stack, resolve9) {
   const cached5 = recursive.get(inst);
   if (cached5 !== void 0)
     return cached5 ? PROVEN : NONE;
@@ -28262,7 +28300,7 @@ function isRecursive(inst, stack, resolve8) {
   let result = NONE;
   const check3 = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve8);
+      const answer = isRecursive(child, stack, resolve9);
       if (answer > result)
         result = answer;
     }
@@ -28273,7 +28311,7 @@ function isRecursive(inst, stack, resolve8) {
       const desc = Object.getOwnPropertyDescriptor(sh, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve8) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve9) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -28337,7 +28375,7 @@ function isRecursive(inst, stack, resolve8) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve8 ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve9 ? inst._zod.innerType : void 0);
       merge2(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -46930,7 +46968,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve8) => setTimeout(resolve8, pollInterval));
+        await new Promise((resolve9) => setTimeout(resolve9, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error62) {
@@ -46947,7 +46985,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve8, reject) => {
+    return new Promise((resolve9, reject) => {
       const earlyReject = (error62) => {
         reject(error62);
       };
@@ -47025,7 +47063,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve8(parseResult.data);
+            resolve9(parseResult.data);
           }
         } catch (error62) {
           reject(error62);
@@ -47287,12 +47325,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve8, reject) => {
+    return new Promise((resolve9, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve8, interval);
+      const timeoutId = setTimeout(resolve9, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -48435,7 +48473,7 @@ var McpServer = class {
     let task = createTaskResult.task;
     const pollInterval = task.pollInterval ?? 5e3;
     while (task.status !== "completed" && task.status !== "failed" && task.status !== "cancelled") {
-      await new Promise((resolve8) => setTimeout(resolve8, pollInterval));
+      await new Promise((resolve9) => setTimeout(resolve9, pollInterval));
       const updatedTask = await extra.taskStore.getTask(taskId);
       if (!updatedTask) {
         throw new McpError(ErrorCode.InternalError, `Task ${taskId} not found during polling`);
@@ -49101,12 +49139,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve8) => {
+    return new Promise((resolve9) => {
       const json2 = serializeMessage(message);
       if (this._stdout.write(json2)) {
-        resolve8();
+        resolve9();
       } else {
-        this._stdout.once("drain", resolve8);
+        this._stdout.once("drain", resolve9);
       }
     });
   }
@@ -49271,6 +49309,33 @@ var ConfigSchema = external_exports.object({
         }).optional()
       })
     ).default([])
+  }).prefault({}),
+  usage: external_exports.object({
+    /** Ingest Claude Code transcripts (tokens, cache, cost per model call) and record statusline snapshots. */
+    enabled: external_exports.boolean().default(true),
+    /** Soft budgets; crossing one adds a one-line warning to the next prompt (never blocks). */
+    budgets: external_exports.object({
+      sessionUsd: external_exports.number().positive().optional(),
+      dailyUsd: external_exports.number().positive().optional(),
+      /** A single API call above this is flagged as an expensive turn. */
+      turnUsd: external_exports.number().positive().optional()
+    }).prefault({}),
+    /**
+     * Price overrides per model, USD per million tokens, matched by substring of the model id
+     * (first match wins). Missing fields fall back to the bundled table.
+     */
+    pricing: external_exports.record(
+      external_exports.string(),
+      external_exports.object({
+        input: external_exports.number().nonnegative().optional(),
+        output: external_exports.number().nonnegative().optional(),
+        cacheWrite5m: external_exports.number().nonnegative().optional(),
+        cacheWrite1h: external_exports.number().nonnegative().optional(),
+        cacheRead: external_exports.number().nonnegative().optional()
+      })
+    ).default({}),
+    /** Show cost, context and plan usage segments in `eminiar statusline`. */
+    statusline: external_exports.boolean().default(true)
   }).prefault({})
 });
 function readJson(file3) {
@@ -49520,6 +49585,10 @@ function topTermsOf(bodies, limit) {
 
 // src/storage/sqlite/schema.ts
 init_esm_shims();
+function hasColumn(db, table, column) {
+  const cols = db.pragma(`table_info(${table})`);
+  return cols.some((c) => c.name === column);
+}
 var migrations = [
   {
     version: 1,
@@ -49781,6 +49850,116 @@ CREATE TABLE IF NOT EXISTS index_runs (
   detail TEXT
 );
 `
+  },
+  {
+    // Usage insights: api_calls mirrors one API request per Claude Code transcript entry
+    // (deduped on request_id + message_id; cost cached at ingest), tool_uses pairs each
+    // tool_use block with its tool_result size, context_events records compactions,
+    // transcript_files keeps the byte offset so ingest only reads new bytes, and
+    // statusline_snapshots stores what `eminiar statusline` saw. Column names = row fields.
+    version: 5,
+    sql: `
+CREATE TABLE IF NOT EXISTS api_calls (
+  request_id TEXT NOT NULL,
+  message_id TEXT NOT NULL,
+  session_id TEXT NOT NULL,
+  agent_id TEXT,
+  sidechain INTEGER NOT NULL DEFAULT 0,
+  ts INTEGER NOT NULL,
+  model TEXT NOT NULL,
+  input_tokens INTEGER NOT NULL DEFAULT 0,
+  output_tokens INTEGER NOT NULL DEFAULT 0,
+  cache_create_5m INTEGER NOT NULL DEFAULT 0,
+  cache_create_1h INTEGER NOT NULL DEFAULT 0,
+  cache_read INTEGER NOT NULL DEFAULT 0,
+  thinking_tokens INTEGER NOT NULL DEFAULT 0,
+  web_searches INTEGER NOT NULL DEFAULT 0,
+  web_fetches INTEGER NOT NULL DEFAULT 0,
+  service_tier TEXT,
+  speed TEXT,
+  stop_reason TEXT,
+  prompt_id TEXT,
+  git_branch TEXT,
+  cwd TEXT,
+  effort TEXT,
+  version TEXT,
+  entrypoint TEXT,
+  cost_usd REAL,
+  priced INTEGER NOT NULL DEFAULT 0,
+  PRIMARY KEY (request_id, message_id)
+);
+CREATE INDEX IF NOT EXISTS api_calls_session_ts ON api_calls(session_id, ts);
+CREATE INDEX IF NOT EXISTS api_calls_ts ON api_calls(ts);
+
+CREATE TABLE IF NOT EXISTS tool_uses (
+  tool_use_id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  agent_id TEXT,
+  ts INTEGER NOT NULL,
+  tool TEXT NOT NULL,
+  input_chars INTEGER NOT NULL DEFAULT 0,
+  result_chars INTEGER,
+  is_error INTEGER NOT NULL DEFAULT 0,
+  request_id TEXT
+);
+CREATE INDEX IF NOT EXISTS tool_uses_session_ts ON tool_uses(session_id, ts);
+CREATE INDEX IF NOT EXISTS tool_uses_ts ON tool_uses(ts);
+
+CREATE TABLE IF NOT EXISTS context_events (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT NOT NULL,
+  ts INTEGER NOT NULL,
+  kind TEXT NOT NULL,
+  trigger TEXT,
+  pre_tokens INTEGER,
+  post_tokens INTEGER
+);
+CREATE INDEX IF NOT EXISTS context_events_session_ts ON context_events(session_id, ts);
+CREATE INDEX IF NOT EXISTS context_events_ts ON context_events(ts);
+
+CREATE TABLE IF NOT EXISTS transcript_files (
+  path TEXT PRIMARY KEY,
+  session_id TEXT,
+  offset INTEGER NOT NULL DEFAULT 0,
+  size INTEGER NOT NULL DEFAULT 0,
+  mtime INTEGER NOT NULL DEFAULT 0,
+  ingested_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS statusline_snapshots (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT NOT NULL,
+  ts INTEGER NOT NULL,
+  model_id TEXT,
+  cost_usd REAL,
+  api_ms INTEGER,
+  duration_ms INTEGER,
+  ctx_input_tokens INTEGER,
+  ctx_output_tokens INTEGER,
+  ctx_size INTEGER,
+  ctx_used_pct REAL,
+  cache_warm INTEGER,
+  cache_ttl TEXT,
+  five_hour_pct REAL,
+  five_hour_resets_at INTEGER,
+  seven_day_pct REAL,
+  seven_day_resets_at INTEGER,
+  lines_added INTEGER,
+  lines_removed INTEGER
+);
+CREATE INDEX IF NOT EXISTS statusline_snapshots_session_ts ON statusline_snapshots(session_id, ts);
+CREATE INDEX IF NOT EXISTS statusline_snapshots_ts ON statusline_snapshots(ts);
+`
+  },
+  {
+    // transcript_files.head_hash (fingerprint of the file head, so a rewrite with the same
+    // size is noticed) was first added to v5 after v5 had already run on real databases, so
+    // version-5 databases exist both with and without the column. Add it only when missing.
+    version: 6,
+    up(db) {
+      if (!hasColumn(db, "transcript_files", "head_hash"))
+        db.exec("ALTER TABLE transcript_files ADD COLUMN head_hash TEXT");
+    }
   }
 ];
 function vecTableSql(dims) {
@@ -49819,6 +49998,27 @@ function filterSql(f) {
   }
   return { where: clauses.length ? ` AND ${clauses.join(" AND ")}` : "", params };
 }
+function usageWhere(f, opts = {}) {
+  const clauses = ["1=1"];
+  const params = [];
+  if (f.sessionId) {
+    clauses.push("session_id = ?");
+    params.push(f.sessionId);
+  }
+  if (f.since !== void 0) {
+    clauses.push("ts >= ?");
+    params.push(f.since);
+  }
+  if (f.until !== void 0) {
+    clauses.push("ts < ?");
+    params.push(f.until);
+  }
+  if (f.sidechain !== void 0 && opts.sidechain !== null) {
+    const expr = opts.sidechain ?? "sidechain = 1";
+    clauses.push(f.sidechain ? expr : `NOT (${expr})`);
+  }
+  return { where: clauses.join(" AND "), params };
+}
 var SqliteAdapter = class _SqliteAdapter {
   constructor(path3, opts = {}) {
     this.path = path3;
@@ -49871,7 +50071,8 @@ var SqliteAdapter = class _SqliteAdapter {
     if (pending2.length) {
       this.transaction(() => {
         for (const m of pending2) {
-          this.db.exec(m.sql);
+          if (m.sql) this.db.exec(m.sql);
+          m.up?.(this.db);
           this.metaSet("schema_version", String(m.version));
         }
       });
@@ -50090,18 +50291,42 @@ var SqliteAdapter = class _SqliteAdapter {
   }
   vecSearch(embedding, k, filters) {
     if (!this.vectors) return [];
-    const raw = this.db.prepare(
-      "SELECT chunk_id id, distance FROM chunk_vec WHERE embedding MATCH ? AND k = ? ORDER BY distance"
-    ).all(embedding, BigInt(filters ? k * 4 : k));
-    if (!filters || !raw.length) return raw.map((r) => ({ chunkId: r.id, distance: r.distance }));
     const { where, params } = filterSql(filters);
-    const allowed = new Set(
-      this.db.prepare(
-        `SELECT c.id FROM chunks c JOIN documents d ON d.id = c.document_id
-             WHERE c.id IN (${raw.map(() => "?").join(",")})${where}`
-      ).all(...raw.map((r) => r.id), ...params).map((r) => r.id)
-    );
-    return raw.filter((r) => allowed.has(r.id)).slice(0, k).map((r) => ({ chunkId: r.id, distance: r.distance }));
+    if (!where) return this.knn(embedding, k);
+    try {
+      return this.knn(
+        embedding,
+        k,
+        `AND chunk_id IN (SELECT c.id FROM chunks c JOIN documents d ON d.id = c.document_id WHERE 1=1${where})`,
+        params
+      );
+    } catch {
+      return this.vecSearchWidening(embedding, k, where, params);
+    }
+  }
+  knn(embedding, k, extra = "", params = []) {
+    return this.db.prepare(
+      `SELECT chunk_id id, distance FROM chunk_vec WHERE embedding MATCH ? AND k = ? ${extra} ORDER BY distance`
+    ).all(embedding, BigInt(k), ...params).map((r) => ({ chunkId: r.id, distance: r.distance }));
+  }
+  /** Fallback filtered KNN: fetch k*4, k*16, ... nearest until k pass the filter or all were seen. */
+  vecSearchWidening(embedding, k, where, params) {
+    const total = this.vecCount();
+    for (let fetch2 = k * 4; ; fetch2 *= 4) {
+      const raw = this.knn(embedding, Math.min(fetch2, total));
+      if (!raw.length) return [];
+      const allowed = /* @__PURE__ */ new Set();
+      for (let i = 0; i < raw.length; i += 400) {
+        const ids = raw.slice(i, i + 400).map((r) => r.chunkId);
+        for (const r of this.db.prepare(
+          `SELECT c.id FROM chunks c JOIN documents d ON d.id = c.document_id
+             WHERE c.id IN (${ids.map(() => "?").join(",")})${where}`
+        ).all(...ids, ...params))
+          allowed.add(r.id);
+      }
+      const hits = raw.filter((r) => allowed.has(r.chunkId)).slice(0, k);
+      if (hits.length >= k || fetch2 >= total) return hits;
+    }
   }
   unembeddedChunkIds(limit) {
     return this.db.prepare("SELECT id FROM chunks WHERE embedded = 0 ORDER BY id LIMIT ?").all(limit).map((r) => r.id);
@@ -50380,6 +50605,26 @@ var SqliteAdapter = class _SqliteAdapter {
     }
     return out;
   }
+  graphDependentFileCounts(paths2, kinds) {
+    const out = /* @__PURE__ */ new Map();
+    if (!paths2.length || !kinds.length) return out;
+    const kph = kinds.map(() => "?").join(",");
+    for (let i = 0; i < paths2.length; i += 400) {
+      const batch = paths2.slice(i, i + 400);
+      const pph = batch.map(() => "?").join(",");
+      for (const r of this.db.prepare(
+        `SELECT d.path p, COUNT(DISTINCT s.path) n
+             FROM graph_nodes d
+             JOIN graph_edges e ON e.dst = d.id AND e.kind IN (${kph})
+             JOIN graph_nodes s ON s.id = e.src
+            WHERE d.path IN (${pph}) AND s.path IS NOT NULL AND s.path <> d.path
+            GROUP BY d.path`
+      ).all(...kinds, ...batch)) {
+        out.set(r.p, r.n);
+      }
+    }
+    return out;
+  }
   edgesWhere(col, ids, kinds) {
     if (!ids.length) return [];
     const out = [];
@@ -50694,6 +50939,233 @@ var SqliteAdapter = class _SqliteAdapter {
   memoryCount() {
     return this.db.prepare("SELECT COUNT(*) n FROM memories").get().n;
   }
+  // --- usage: model calls, tool results, context events, statusline ------------
+  apiCallsUpsert(rows) {
+    if (!rows.length) return 0;
+    const ins = this.prep(
+      `INSERT INTO api_calls (request_id, message_id, session_id, agent_id, sidechain, ts, model,
+         input_tokens, output_tokens, cache_create_5m, cache_create_1h, cache_read, thinking_tokens,
+         web_searches, web_fetches, service_tier, speed, stop_reason, prompt_id, git_branch, cwd, effort,
+         version, entrypoint, cost_usd, priced)
+       VALUES (@request_id, @message_id, @session_id, @agent_id, @sidechain, @ts, @model,
+         @input_tokens, @output_tokens, @cache_create_5m, @cache_create_1h, @cache_read, @thinking_tokens,
+         @web_searches, @web_fetches, @service_tier, @speed, @stop_reason, @prompt_id, @git_branch, @cwd, @effort,
+         @version, @entrypoint, @cost_usd, @priced)
+       ON CONFLICT(request_id, message_id) DO UPDATE SET
+         cost_usd = CASE WHEN excluded.output_tokens >= api_calls.output_tokens THEN excluded.cost_usd ELSE api_calls.cost_usd END,
+         priced = CASE WHEN excluded.output_tokens >= api_calls.output_tokens THEN excluded.priced ELSE api_calls.priced END,
+         input_tokens = MAX(api_calls.input_tokens, excluded.input_tokens),
+         output_tokens = MAX(api_calls.output_tokens, excluded.output_tokens),
+         cache_create_5m = MAX(api_calls.cache_create_5m, excluded.cache_create_5m),
+         cache_create_1h = MAX(api_calls.cache_create_1h, excluded.cache_create_1h),
+         cache_read = MAX(api_calls.cache_read, excluded.cache_read),
+         thinking_tokens = MAX(api_calls.thinking_tokens, excluded.thinking_tokens),
+         web_searches = MAX(api_calls.web_searches, excluded.web_searches),
+         web_fetches = MAX(api_calls.web_fetches, excluded.web_fetches),
+         stop_reason = COALESCE(excluded.stop_reason, api_calls.stop_reason),
+         service_tier = COALESCE(excluded.service_tier, api_calls.service_tier),
+         speed = COALESCE(excluded.speed, api_calls.speed),
+         prompt_id = COALESCE(api_calls.prompt_id, excluded.prompt_id),
+         effort = COALESCE(api_calls.effort, excluded.effort)`
+    );
+    const count = this.prep("SELECT COUNT(*) AS n FROM api_calls");
+    return this.transaction(() => {
+      const before = count.get().n;
+      for (const r of rows) {
+        ins.run({
+          request_id: r.request_id,
+          message_id: r.message_id,
+          session_id: r.session_id,
+          agent_id: r.agent_id ?? null,
+          sidechain: r.sidechain ? 1 : 0,
+          ts: r.ts,
+          model: r.model,
+          input_tokens: r.input_tokens,
+          output_tokens: r.output_tokens,
+          cache_create_5m: r.cache_create_5m,
+          cache_create_1h: r.cache_create_1h,
+          cache_read: r.cache_read,
+          thinking_tokens: r.thinking_tokens,
+          web_searches: r.web_searches,
+          web_fetches: r.web_fetches,
+          service_tier: r.service_tier ?? null,
+          speed: r.speed ?? null,
+          stop_reason: r.stop_reason ?? null,
+          prompt_id: r.prompt_id ?? null,
+          git_branch: r.git_branch ?? null,
+          cwd: r.cwd ?? null,
+          effort: r.effort ?? null,
+          version: r.version ?? null,
+          entrypoint: r.entrypoint ?? null,
+          cost_usd: r.cost_usd ?? null,
+          priced: r.priced ?? 0
+        });
+      }
+      return count.get().n - before;
+    });
+  }
+  apiCalls(filter = {}) {
+    const { where, params } = usageWhere(filter);
+    params.push(filter.limit ?? 1e5);
+    return this.prep(
+      `SELECT * FROM api_calls WHERE ${where} ORDER BY ts ASC, rowid ASC LIMIT ?`
+    ).all(...params);
+  }
+  apiCallsLatestTs() {
+    const row = this.prep("SELECT MAX(ts) AS ts FROM api_calls").get();
+    return row?.ts ?? void 0;
+  }
+  toolUsesUpsert(rows) {
+    if (!rows.length) return 0;
+    const ins = this.prep(
+      `INSERT INTO tool_uses (tool_use_id, session_id, agent_id, ts, tool, input_chars, result_chars, is_error, request_id)
+       VALUES (@tool_use_id, @session_id, @agent_id, @ts, @tool, @input_chars, @result_chars, @is_error, @request_id)
+       ON CONFLICT(tool_use_id) DO UPDATE SET
+         tool = CASE WHEN tool_uses.tool = '' THEN excluded.tool ELSE tool_uses.tool END,
+         input_chars = MAX(tool_uses.input_chars, excluded.input_chars),
+         result_chars = COALESCE(excluded.result_chars, tool_uses.result_chars),
+         is_error = MAX(tool_uses.is_error, excluded.is_error),
+         request_id = COALESCE(tool_uses.request_id, excluded.request_id),
+         agent_id = COALESCE(tool_uses.agent_id, excluded.agent_id),
+         ts = MIN(tool_uses.ts, excluded.ts)`
+    );
+    const count = this.prep("SELECT COUNT(*) AS n FROM tool_uses");
+    return this.transaction(() => {
+      const before = count.get().n;
+      for (const r of rows) {
+        ins.run({
+          tool_use_id: r.tool_use_id,
+          session_id: r.session_id,
+          agent_id: r.agent_id ?? null,
+          ts: r.ts,
+          tool: r.tool,
+          input_chars: r.input_chars,
+          result_chars: r.result_chars ?? null,
+          is_error: r.is_error ? 1 : 0,
+          request_id: r.request_id ?? null
+        });
+      }
+      return count.get().n - before;
+    });
+  }
+  toolUses(filter = {}) {
+    const { where, params } = usageWhere(filter, { sidechain: "agent_id IS NOT NULL" });
+    params.push(filter.limit ?? 1e5);
+    return this.prep(
+      `SELECT * FROM tool_uses WHERE ${where} ORDER BY ts ASC, rowid ASC LIMIT ?`
+    ).all(...params);
+  }
+  contextEventInsert(e) {
+    const info = this.prep(
+      `INSERT INTO context_events (session_id, ts, kind, trigger, pre_tokens, post_tokens)
+       VALUES (?, ?, ?, ?, ?, ?)`
+    ).run(
+      e.session_id,
+      e.ts,
+      e.kind,
+      e.trigger ?? null,
+      e.pre_tokens ?? null,
+      e.post_tokens ?? null
+    );
+    return Number(info.lastInsertRowid);
+  }
+  contextEvents(filter = {}) {
+    const { where, params } = usageWhere(filter, { sidechain: null });
+    params.push(filter.limit ?? 1e5);
+    return this.prep(
+      `SELECT * FROM context_events WHERE ${where} ORDER BY ts ASC, id ASC LIMIT ?`
+    ).all(...params);
+  }
+  transcriptFileGet(path3) {
+    return this.prep("SELECT * FROM transcript_files WHERE path = ?").get(path3);
+  }
+  transcriptFileSet(row) {
+    this.prep(
+      `INSERT INTO transcript_files (path, session_id, offset, size, mtime, head_hash, ingested_at)
+       VALUES (@path, @session_id, @offset, @size, @mtime, @head_hash, @ingested_at)
+       ON CONFLICT(path) DO UPDATE SET
+         session_id = COALESCE(excluded.session_id, transcript_files.session_id),
+         offset = excluded.offset, size = excluded.size, mtime = excluded.mtime,
+         head_hash = excluded.head_hash, ingested_at = excluded.ingested_at`
+    ).run({
+      path: row.path,
+      session_id: row.session_id ?? null,
+      offset: row.offset,
+      size: row.size,
+      mtime: row.mtime,
+      head_hash: row.head_hash ?? null,
+      ingested_at: row.ingested_at
+    });
+  }
+  transcriptFiles() {
+    return this.prep("SELECT * FROM transcript_files ORDER BY path").all();
+  }
+  statuslineSnapshotInsert(s) {
+    const info = this.prep(
+      `INSERT INTO statusline_snapshots (session_id, ts, model_id, cost_usd, api_ms, duration_ms,
+         ctx_input_tokens, ctx_output_tokens, ctx_size, ctx_used_pct, cache_warm, cache_ttl,
+         five_hour_pct, five_hour_resets_at, seven_day_pct, seven_day_resets_at, lines_added, lines_removed)
+       VALUES (@session_id, @ts, @model_id, @cost_usd, @api_ms, @duration_ms,
+         @ctx_input_tokens, @ctx_output_tokens, @ctx_size, @ctx_used_pct, @cache_warm, @cache_ttl,
+         @five_hour_pct, @five_hour_resets_at, @seven_day_pct, @seven_day_resets_at, @lines_added, @lines_removed)`
+    ).run({
+      session_id: s.session_id,
+      ts: s.ts,
+      model_id: s.model_id ?? null,
+      cost_usd: s.cost_usd ?? null,
+      api_ms: s.api_ms ?? null,
+      duration_ms: s.duration_ms ?? null,
+      ctx_input_tokens: s.ctx_input_tokens ?? null,
+      ctx_output_tokens: s.ctx_output_tokens ?? null,
+      ctx_size: s.ctx_size ?? null,
+      ctx_used_pct: s.ctx_used_pct ?? null,
+      cache_warm: s.cache_warm ?? null,
+      cache_ttl: s.cache_ttl ?? null,
+      five_hour_pct: s.five_hour_pct ?? null,
+      five_hour_resets_at: s.five_hour_resets_at ?? null,
+      seven_day_pct: s.seven_day_pct ?? null,
+      seven_day_resets_at: s.seven_day_resets_at ?? null,
+      lines_added: s.lines_added ?? null,
+      lines_removed: s.lines_removed ?? null
+    });
+    return Number(info.lastInsertRowid);
+  }
+  statuslineSnapshots(filter = {}) {
+    const { where, params } = usageWhere(filter, { sidechain: null });
+    params.push(filter.limit ?? 1e5);
+    return this.prep(
+      `SELECT * FROM statusline_snapshots WHERE ${where} ORDER BY ts ASC, id ASC LIMIT ?`
+    ).all(...params);
+  }
+  statuslineLatest(sessionId) {
+    if (sessionId) {
+      return this.prep(
+        "SELECT * FROM statusline_snapshots WHERE session_id = ? ORDER BY ts DESC, id DESC LIMIT 1"
+      ).get(sessionId);
+    }
+    return this.prep(
+      "SELECT * FROM statusline_snapshots ORDER BY ts DESC, id DESC LIMIT 1"
+    ).get();
+  }
+  statuslineSnapshotsPrune(opts) {
+    const keep = Math.max(0, Math.floor(opts.keepPerSession));
+    return this.transaction(() => {
+      let n = this.prep("DELETE FROM statusline_snapshots WHERE ts < ?").run(
+        opts.olderThan
+      ).changes;
+      n += this.prep(
+        `DELETE FROM statusline_snapshots WHERE id IN (
+           SELECT s.id FROM statusline_snapshots s
+           WHERE s.id NOT IN (
+             SELECT k.id FROM statusline_snapshots k
+             WHERE k.session_id = s.session_id
+             ORDER BY k.ts DESC, k.id DESC LIMIT ?
+           )
+         )`
+      ).run(keep).changes;
+      return n;
+    });
+  }
   // --- misc --------------------------------------------------------------
   metaGet(key) {
     const row = this.db.prepare("SELECT value FROM meta WHERE key = ?").get(key);
@@ -50724,6 +51196,11 @@ var SqliteAdapter = class _SqliteAdapter {
           "DELETE FROM graph_edges; DELETE FROM graph_nodes; DELETE FROM graph_metrics;"
         );
       }
+      if (scope === "usage" || scope === "all") {
+        this.db.exec(
+          "DELETE FROM api_calls; DELETE FROM tool_uses; DELETE FROM context_events; DELETE FROM transcript_files; DELETE FROM statusline_snapshots;"
+        );
+      }
       if (scope === "memories" || scope === "all") {
         this.db.exec("DELETE FROM memories;");
         if (scope === "memories") {
@@ -50813,7 +51290,7 @@ function impact(db, ref, opts = {}) {
   const depth = opts.depth ?? 2;
   const kinds = opts.edgeKinds ?? STRUCTURAL;
   const hits = /* @__PURE__ */ new Map();
-  const add = (id, score, hops, reason) => {
+  const add2 = (id, score, hops, reason) => {
     const key = toFile(id);
     if (key === toFile(root.id)) return;
     const h = hits.get(key) ?? { id: key, score: 0, hops, reasons: [] };
@@ -50830,7 +51307,7 @@ function impact(db, ref, opts = {}) {
     const next = [];
     for (const e of incoming) {
       const via = e.dst === root.id ? root.name : e.dst.replace(/^sym:[^#]*#/, "");
-      add(
+      add2(
         e.src,
         e.confidence * e.weight / hop,
         hop,
@@ -50847,14 +51324,14 @@ function impact(db, ref, opts = {}) {
   for (const e of db.graphEdgesTo(start, ["mentions", "documents"])) {
     const via = e.dst === root.id ? root.name : e.dst.replace(/^sym:[^#]*#/, "");
     const who = e.kind === "documents" ? "doc documents" : "memory mentions";
-    add(e.src, 0.5 * e.confidence, 1, `${who} ${via}`);
+    add2(e.src, 0.5 * e.confidence, 1, `${who} ${via}`);
   }
   if (opts.includeGit !== false) {
     const file3 = toFile(root.id);
     for (const e of db.graphEdgesFrom([file3], ["co_changes"])) {
       if (e.weight < 0.3) continue;
       const meta4 = e.meta ? JSON.parse(e.meta) : {};
-      add(e.dst, e.weight, 1, `co-changed ${meta4.count ?? "?"}\xD7 (${Math.round(e.weight * 100)}%)`);
+      add2(e.dst, e.weight, 1, `co-changed ${meta4.count ?? "?"}\xD7 (${Math.round(e.weight * 100)}%)`);
     }
   }
   const list2 = [...hits.values()].sort((a, b) => b.score - a.score);
@@ -51198,7 +51675,7 @@ function pkgJson(root) {
 }
 function folderRows(files, languages2) {
   const acc = /* @__PURE__ */ new Map();
-  const add = (key, r) => {
+  const add2 = (key, r) => {
     const a = acc.get(key) ?? { files: 0, loc: 0, score: 0, langs: {} };
     a.files++;
     a.loc += r.loc;
@@ -51209,8 +51686,8 @@ function folderRows(files, languages2) {
   };
   for (const r of files) {
     const parts = (r.path ?? "").split("/");
-    add(parts.length > 1 ? `${parts[0]}/` : "(root)", r);
-    if (parts.length > 2) add(`${parts[0]}/${parts[1]}/`, r);
+    add2(parts.length > 1 ? `${parts[0]}/` : "(root)", r);
+    if (parts.length > 2) add2(`${parts[0]}/${parts[1]}/`, r);
   }
   const rows = [...acc.entries()].map(([path3, a]) => ({
     path: path3,
@@ -52283,6 +52760,25 @@ function findOnPath(bin) {
   }
   return void 0;
 }
+var REQUIRE_PREAMBLE = 'import { createRequire } from "node:module"; const require = createRequire(process.env.EMINIAR_PROJECT_ROOT ? process.env.EMINIAR_PROJECT_ROOT + "/package.json" : import.meta.url);';
+function requirePreamble(code) {
+  if (!/\brequire\s*\(/.test(code)) return void 0;
+  if (/\b(?:const|let|var|function)\s+require\b/.test(code) || /\bcreateRequire\b/.test(code)) {
+    return void 0;
+  }
+  return `${REQUIRE_PREAMBLE}
+`;
+}
+function prepareCode(lang, code) {
+  const pre = lang.preamble?.(code);
+  if (!pre) return code;
+  if (code.startsWith("#!")) {
+    const nl = code.indexOf("\n");
+    return nl === -1 ? `${code}
+${pre}` : code.slice(0, nl + 1) + pre + code.slice(nl + 1);
+  }
+  return pre + code;
+}
 function preferredShell() {
   const sh = process.env.SHELL ?? "";
   if (/\/(zsh|bash)$/.test(sh) && existsSync11(sh)) return sh;
@@ -52315,14 +52811,16 @@ var LANGUAGES = [
     aliases: ["js", "node", "mjs"],
     ext: ".mjs",
     detect: () => process.execPath,
-    argv: (bin, file3) => [bin, "--no-warnings", file3]
+    argv: (bin, file3) => [bin, "--no-warnings", file3],
+    preamble: requirePreamble
   },
   {
     id: "typescript",
     aliases: ["ts"],
     ext: ".ts",
     detect: () => process.execPath,
-    argv: (bin, file3) => [bin, "--no-warnings", tsxCli(), file3]
+    argv: (bin, file3) => [bin, "--no-warnings", tsxCli(), file3],
+    preamble: requirePreamble
   },
   {
     id: "python",
@@ -52425,7 +52923,7 @@ init_esm_shims();
 import { spawn } from "child_process";
 function runProcess(argv, opts) {
   const started = Date.now();
-  return new Promise((resolve8) => {
+  return new Promise((resolve9) => {
     const [cmd, ...args] = argv;
     const child = spawn(cmd, args, {
       cwd: opts.cwd,
@@ -52468,7 +52966,7 @@ function runProcess(argv, opts) {
       if (done) return;
       done = true;
       clearTimeout(timer);
-      resolve8({
+      resolve9({
         stdout: Buffer.concat(out).toString("utf8"),
         stderr: errTail,
         exitCode,
@@ -52508,7 +53006,7 @@ async function execute(ctx, input2) {
       );
     }
   }
-  const file3 = writeScratch(input2.code, lang.ext);
+  const file3 = writeScratch(prepareCode(lang, input2.code), lang.ext);
   const env = buildEnv(ctx.config.sandbox.envAllow, {
     EMINIAR_PROJECT_ROOT: ctx.root,
     NODE_PATH: [join17(ctx.root, "node_modules"), process.env.NODE_PATH].filter(Boolean).join(":"),
@@ -52958,10 +53456,22 @@ searchable terms: ${terms.join(", ")}`);
 }
 
 // src/tools/em_batch_execute.ts
-var INLINE_LIMIT = 1024;
+var INLINE_LIMIT_WITH_QUERIES = 1024;
+var DEFAULT_MAX_TOKENS = 2e3;
+function chooseInline(lengths, perOutputCap, budgetChars) {
+  const candidates2 = lengths.map((len, i) => ({ len, i })).filter((c) => c.len <= perOutputCap).sort((a, b) => a.len - b.len);
+  const inline = /* @__PURE__ */ new Set();
+  let remaining = budgetChars;
+  for (const c of candidates2) {
+    if (c.len > remaining) break;
+    inline.add(c.i);
+    remaining -= c.len;
+  }
+  return inline;
+}
 var emBatchExecute = defineTool({
   name: "em_batch_execute",
-  description: "Run several labelled commands in parallel, index every output under its label, and answer `queries` against all of them in the same round trip. Ideal for research: git status + recent commits + test output + dependency list in one call. Small outputs are returned inline; large ones only through the query hits.",
+  description: "Run several labelled commands in parallel, index every output under its label, and answer `queries` against all of them in the same round trip. Ideal for research: git status + recent commits + test output + dependency list in one call. Without `queries`/`intent`, each output up to the index threshold (5 KB) is returned inline, within `max_tokens` overall; with them, only outputs up to 1 KB are inlined and the query hits carry the rest. Every output is indexed; an elided one is fetched with em_search {document_ids: [N]}.",
   schema: {
     commands: external_exports.array(
       external_exports.object({
@@ -52982,6 +53492,9 @@ var emBatchExecute = defineTool({
     const concurrency = args.concurrency ?? 4;
     const results = [];
     let rawChars = 0;
+    const queries = [...args.queries ?? []];
+    if (args.intent && !queries.includes(args.intent)) queries.unshift(args.intent);
+    const maxTokens = args.max_tokens ?? DEFAULT_MAX_TOKENS;
     const queue = [...args.commands];
     const worker = async () => {
       for (; ; ) {
@@ -53003,7 +53516,7 @@ var emBatchExecute = defineTool({
           results.push({
             label: cmd.label,
             header: describeRun(r),
-            inline: r.stdout.length <= INLINE_LIMIT ? r.stdout : void 0,
+            stdout: r.stdout,
             docId: p.documentId,
             stderr: r.exitCode !== 0 ? r.stderr.trim().slice(-800) : void 0
           });
@@ -53015,15 +53528,21 @@ var emBatchExecute = defineTool({
     await Promise.all(Array.from({ length: Math.min(concurrency, queue.length) }, worker));
     const order = new Map(args.commands.map((c, i) => [c.label, i]));
     results.sort((a, b) => (order.get(a.label) ?? 0) - (order.get(b.label) ?? 0));
+    const perOutputCap = queries.length ? INLINE_LIMIT_WITH_QUERIES : ctx.config.sandbox.indexThreshold;
+    const inline = chooseInline(
+      results.map((r) => r.stdout?.length ?? Number.POSITIVE_INFINITY),
+      perOutputCap,
+      maxTokens * 4
+    );
     const lines = [];
-    for (const r of results) {
-      lines.push(`## ${r.label} \u2014 ${r.header}${r.docId ? ` \xB7 doc ${r.docId}` : ""}`);
-      if (r.inline !== void 0) lines.push(r.inline.trimEnd());
+    results.forEach((r, i) => {
+      const shown = inline.has(i) && r.stdout !== void 0;
+      const hint = r.docId && !shown ? ` \xB7 em_search {document_ids: [${r.docId}]} for the output` : "";
+      lines.push(`## ${r.label} \u2014 ${r.header}${r.docId ? ` \xB7 doc ${r.docId}` : ""}${hint}`);
+      if (shown) lines.push(r.stdout.trimEnd());
       if (r.stderr) lines.push(`stderr: ${r.stderr}`);
       lines.push("");
-    }
-    const queries = [...args.queries ?? []];
-    if (args.intent && !queries.includes(args.intent)) queries.unshift(args.intent);
+    });
     const docIds = results.map((r) => r.docId).filter((d) => d !== void 0);
     if (queries.length && docIds.length) {
       const responses = [];
@@ -53033,7 +53552,7 @@ var emBatchExecute = defineTool({
         );
       }
       lines.push("# query hits");
-      lines.push(formatResults(responses, args.max_tokens ?? 2e3));
+      lines.push(formatResults(responses, maxTokens));
     }
     const out = lines.join("\n");
     recordStat(ctx, "em_batch_execute", {
@@ -54095,6 +54614,9 @@ var NAME_RE2 = /^[a-z0-9][a-z0-9._-]{0,63}$/;
 function docsTag(name) {
   return `${DOCS_PREFIX}${name}`;
 }
+function nameFromTag(tag) {
+  return tag.startsWith(DOCS_PREFIX) ? tag.slice(DOCS_PREFIX.length) : void 0;
+}
 function isValidName2(name) {
   return NAME_RE2.test(name);
 }
@@ -55026,7 +55548,7 @@ function discoverDocs(ctx, opts = {}) {
     }
   }
   const byName = /* @__PURE__ */ new Map();
-  const add = (c) => {
+  const add2 = (c) => {
     const cur = byName.get(c.name);
     if (cur) {
       if (!cur.usedBy.includes(c.usedBy)) cur.usedBy.push(c.usedBy);
@@ -55052,7 +55574,7 @@ function discoverDocs(ctx, opts = {}) {
     const entry = catalogLookup(s.kind, s.key, catalog);
     const evidence = `${s.kind}:${s.key}`;
     if (entry) {
-      add({
+      add2({
         name: entry.id,
         provider: `${s.kind}:${s.key}`,
         title: entry.title,
@@ -55069,7 +55591,7 @@ function discoverDocs(ctx, opts = {}) {
       continue;
     }
     if (s.kind === "npm" || s.kind === "pypi" || s.kind === "go") {
-      add({
+      add2({
         name: slugify3(s.key.replace(/^github\.com\//, "")),
         provider: `${s.kind}:${s.key}`,
         title: s.key,
@@ -55079,7 +55601,7 @@ function discoverDocs(ctx, opts = {}) {
         evidence
       });
     } else if (s.kind === "image" && !s.key.includes(".") && !s.key.includes("/")) {
-      add({
+      add2({
         name: slugify3(s.key.split(":")[0]),
         provider: `image:${s.key.split(":")[0]}`,
         title: s.key.split(":")[0],
@@ -55094,7 +55616,7 @@ function discoverDocs(ctx, opts = {}) {
     if (info.vars.length < 2) continue;
     const provider = `env:${token}`;
     for (const p of info.projects)
-      add({
+      add2({
         name: slugify3(token),
         provider,
         title: token,
@@ -55113,7 +55635,7 @@ function discoverDocs(ctx, opts = {}) {
       if (!h.calls) continue;
       const evidence = `api:${host} (${h.samples.slice(0, 2).join(", ")})${specUrls.length ? ` \xB7 spec ${specUrls[0]}` : ""}`;
       if (entry) {
-        add({
+        add2({
           name: entry.id,
           provider: `api:${host}`,
           title: entry.title,
@@ -55129,7 +55651,7 @@ function discoverDocs(ctx, opts = {}) {
         for (const u of specUrls) if (!c.urls.includes(u)) c.urls.push(u);
       } else {
         const domain2 = rootDomain(host);
-        add({
+        add2({
           name: slugify3(domain2.replace(/\.[a-z.]+$/, "")),
           provider: `api:${host}`,
           title: `${domain2} API`,
@@ -55148,7 +55670,7 @@ function discoverDocs(ctx, opts = {}) {
     for (const l of list2) {
       const evidence = `link:${host} (${l.samples.slice(0, 2).join(", ")})`;
       if (entry) {
-        add({
+        add2({
           name: entry.id,
           provider: `link:${host}`,
           title: entry.title,
@@ -55172,7 +55694,7 @@ function discoverDocs(ctx, opts = {}) {
         if (!existing.usedBy.includes(l.project || ".")) existing.usedBy.push(l.project || ".");
         continue;
       }
-      add({
+      add2({
         name,
         provider: `link:${host}`,
         title: `${host} (documentation linked from code)`,
@@ -56546,7 +57068,7 @@ function removeDocSource(ctx, db, name) {
   const removed = removeSource(ctx, name);
   const documents = db.deleteDocumentsBySource(docsTag(name));
   clearSyncState(db, name);
-  if (removed) syncDocsGraphQuietly(ctx, db);
+  if (removed || documents) syncDocsGraphQuietly(ctx, db);
   return { removed, documents };
 }
 function formatAdd(o) {
@@ -56617,6 +57139,26 @@ function ago(ts) {
   if (s < 172800) return `${Math.round(s / 3600)}h ago`;
   return `${Math.round(s / 86400)}d ago`;
 }
+function orphanedDocSources(db, registered, stats = db.documentSourceStats(DOCS_PREFIX)) {
+  const known = new Set(registered);
+  const out = [];
+  for (const s of stats) {
+    const name = nameFromTag(s.source);
+    if (name === void 0 || known.has(name)) continue;
+    out.push({ name, documents: s.documents, chunks: s.chunks, latest: s.latest });
+  }
+  return out;
+}
+function formatOrphans(orphans2) {
+  const names = orphans2.map((o) => o.name);
+  return [
+    `# Orphaned in the index (${orphans2.length}; pages without a manifest entry)`,
+    ...orphans2.map(
+      (o) => `- ${o.name} \xB7 ${o.documents} doc(s) \xB7 ${o.chunks} chunks \xB7 indexed ${ago(o.latest)}`
+    ),
+    `em_docs {action:"remove", names:${JSON.stringify(names)}} drops them; {action:"add", pick:"recommended"} or {action:"add", name, url|path} re-registers.`
+  ];
+}
 function formatDiscovery(d, max = 40) {
   const lines = [];
   lines.push(
@@ -56675,8 +57217,8 @@ function formatDiscovery(d, max = 40) {
     for (const p of list2.slice(0, max)) {
       const used = p.usedBy.length > 1 ? ` \xB7 used by ${p.usedBy.length} projects` : p.usedBy[0] && p.usedBy[0] !== "." ? ` \xB7 ${p.usedBy[0]}` : "";
       const where = p.urls[0] ? ` \xB7 ${p.urls[0]}` : "";
-      const ev = conf === "probe" || conf === "unknown" ? ` \xB7 ${p.evidence[0]}` : "";
-      lines.push(`- ${p.name} \u2190 ${p.provider}${used}${where}${ev}${reg(p.registered)}`);
+      const ev2 = conf === "probe" || conf === "unknown" ? ` \xB7 ${p.evidence[0]}` : "";
+      lines.push(`- ${p.name} \u2190 ${p.provider}${used}${where}${ev2}${reg(p.registered)}`);
     }
     if (list2.length > max) lines.push(`  \u2026 ${list2.length - max} more`);
   }
@@ -56764,19 +57306,30 @@ var emDocs = defineTool({
         case "remove": {
           const names = [...args.name ? [args.name] : [], ...args.names ?? []];
           if (!names.length) return errorResult("remove needs `name` or `names`");
+          let unknown2 = 0;
           const lines = names.map((n) => {
             const r = removeDocSource(ctx, db, n);
-            return r.removed ? `removed ${n} (${r.documents} document(s) dropped)` : `${n}: not registered${r.documents ? ` (${r.documents} orphan document(s) dropped)` : ""}`;
+            if (r.removed) return `removed ${n} (${r.documents} document(s) dropped)`;
+            if (r.documents) return `removed ${n} (orphaned; ${r.documents} document(s) dropped)`;
+            unknown2++;
+            return `${n}: not registered and not in the index; em_docs {action:"list"} shows both`;
           });
-          return done(lines.join("\n"));
+          const out = lines.join("\n");
+          return unknown2 === names.length ? errorResult(out) : done(out);
         }
         case "list": {
           const m = readManifest(ctx);
-          if (!m.sources.length)
-            return done(
-              `no documentation sources registered (${manifestPath(ctx)}). em_docs {action:"discover"} finds local docs and the libraries, services and APIs this project uses.`
-            );
-          const stats = new Map(db.documentSourceStats(DOCS_PREFIX).map((s) => [s.source, s]));
+          const sourceStats = db.documentSourceStats(DOCS_PREFIX);
+          const orphans2 = orphanedDocSources(
+            db,
+            m.sources.map((s) => s.name),
+            sourceStats
+          );
+          if (!m.sources.length) {
+            const none = `no documentation sources registered (${manifestPath(ctx)}). em_docs {action:"discover"} finds local docs and the libraries, services and APIs this project uses.`;
+            return done(orphans2.length ? [none, "", ...formatOrphans(orphans2)].join("\n") : none);
+          }
+          const stats = new Map(sourceStats.map((s) => [s.source, s]));
           const catalog = mergedCatalog(ctx.config.docs.catalog);
           const categorised = m.sources.map((s) => ({
             s,
@@ -56807,9 +57360,10 @@ var emDocs = defineTool({
               `- ${s.name} [${s.kind}]${s.provider ? ` \u2190 ${s.provider}` : ""}${s.tags?.length ? ` (${s.tags.join(", ")})` : ""} \xB7 ${st?.documents ?? 0} doc(s) \xB7 ${st?.chunks ?? 0} chunks \xB7 ${state} \xB7 ${where}`
             );
           }
+          if (orphans2.length) lines.push("", ...formatOrphans(orphans2));
           lines.push(
             "",
-            `${m.sources.length} source(s); em_docs {action:"lookup", query} searches them all, {action:"sync"} refreshes.`
+            `${m.sources.length} source(s)${orphans2.length ? ` + ${orphans2.length} orphaned` : ""}; em_docs {action:"lookup", query} searches them all, {action:"sync"} refreshes.`
           );
           return done(lines.join("\n"));
         }
@@ -56855,10 +57409,18 @@ ${r.urls.map((u) => `  ${u}`).join("\n")}
             raw += r.hits.reduce((n, h) => n + h.chunk.body.length, 0);
             responses.push(r);
           }
-          const out = formatResults(
-            responses,
-            args.max_tokens ?? ctx.config.search.defaultMaxTokens
+          let out = formatResults(responses, args.max_tokens ?? ctx.config.search.defaultMaxTokens);
+          const hitSources = new Set(
+            responses.flatMap((r) => r.hits.map((h) => h.chunk.document.source))
           );
+          const orphaned = orphanedDocSources(
+            db,
+            m.sources.map((s) => s.name)
+          ).filter((o) => hitSources.has(docsTag(o.name)));
+          if (orphaned.length)
+            out += `
+
+note: ${orphaned.map((o) => o.name).join(", ")} ${orphaned.length === 1 ? "is" : "are"} not in the manifest (orphaned pages); em_docs {action:"list"} explains`;
           recordStat(ctx, "em_docs", {
             rawChars: raw,
             returnedChars: out.length,
@@ -57089,7 +57651,7 @@ var LANG_ENUM = external_exports.string().describe(
 );
 var emExecute = defineTool({
   name: "em_execute",
-  description: "Run code in a sandbox inside the project root and return only stdout. Output over the index threshold (5 KB) is indexed; pass `intent` to get back just the matching sections plus a vocabulary of searchable terms. Use this instead of Bash for anything that prints a lot: git log/diff, test runs, dependency trees, logs, API calls. Shell snippets honour Claude Code's Bash deny rules.",
+  description: "Run code in a sandbox inside the project root and return only stdout. Output over the index threshold (5 KB) is indexed; pass `intent` to get back just the matching sections plus a vocabulary of searchable terms. Use this instead of Bash for anything that prints a lot: git log/diff, test runs, dependency trees, logs, API calls. Shell snippets honour Claude Code's Bash deny rules. javascript and typescript run as ES modules; `import` and `require` both work.",
   schema: {
     language: LANG_ENUM,
     code: external_exports.string().min(1).describe("Program or shell script to run"),
@@ -57171,7 +57733,7 @@ function refuse(check3, target) {
 // src/tools/em_execute_file.ts
 var emExecuteFile = defineTool({
   name: "em_execute_file",
-  description: "Process a file in the sandbox without reading it into context. Your code receives the absolute path as $EM_FILE (shell) / process.env.EM_FILE (node) / os.environ['EM_FILE'] (python); print only what you need. The file must be inside the project root unless a Read(<path>) allow rule opts it in; a matching Read deny or ask rule refuses the path, inside the root or out. Omit `code` to get a quick summary (size, lines, head).",
+  description: "Process a file in the sandbox without reading it into context. Your code receives the absolute path as $EM_FILE (shell) / process.env.EM_FILE (node) / os.environ['EM_FILE'] (python); print only what you need. The file must be inside the project root unless a Read(<path>) allow rule opts it in; a matching Read deny or ask rule refuses the path, inside the root or out. Omit `code` to get a quick summary (size, lines, head). javascript and typescript run as ES modules; `import` and `require` both work.",
   schema: {
     path: external_exports.string().describe("File to process, relative to the project root or absolute"),
     language: LANG_ENUM.optional(),
@@ -58147,7 +58709,7 @@ var emIndex = defineTool({
       });
       kickEmbedding(ctx, db);
       return text(
-        `${r.created ? "indexed" : "unchanged"} "${args.title}" as doc ${r.documentId}: ${r.chunks} chunks, ${r.chars} chars (${r.kind})`
+        `${r.created ? "indexed" : "unchanged"} "${args.title}" as doc ${r.documentId}: ${r.chunks} chunks, ${r.chars} chars (${r.kind})${r.fallback ? " (no sections found; indexed as one chunk)" : ""}`
       );
     }
     if (!args.path) return errorResult("provide `path` or `content`");
@@ -58157,7 +58719,7 @@ var emIndex = defineTool({
       recursive: args.recursive ?? true
     });
     const lines = [
-      `${args.path}: ${s.files} file(s), ${s.indexed} indexed, ${s.unchanged} unchanged, ${s.chunks} chunks`
+      `${args.path}: ${s.files} file(s), ${s.indexed} indexed, ${s.unchanged} unchanged, ${s.chunks} chunks${s.fallbacks ? ` (${s.fallbacks} with no sections found; indexed as one chunk)` : ""}`
     ];
     for (const sk of s.skipped.slice(0, 10)) lines.push(`  skipped ${sk.path}: ${sk.reason}`);
     if (s.skipped.length > 10) lines.push(`  \u2026 ${s.skipped.length - 10} more skipped`);
@@ -58341,9 +58903,9 @@ ${body}`);
 init_esm_shims();
 var emPurge = defineTool({
   name: "em_purge",
-  description: "Permanently delete eminiar data for this project. scope: index (documents/chunks/vectors/caches), sessions (events, snapshots, stats), graph, memories (the database mirror only; the markdown files under .eminiar/memories stay and are re-imported on the next memory call \u2014 delete files with em_memory), or all. Requires confirm: true.",
+  description: "Permanently delete eminiar data for this project. scope: index (documents/chunks/vectors/caches), sessions (events, snapshots, stats), graph, memories (the database mirror only; the markdown files under .eminiar/memories stay and are re-imported on the next memory call \u2014 delete files with em_memory), usage (API calls, tool uses, context events, transcript offsets, statusline snapshots), or all. Requires confirm: true.",
   schema: {
-    scope: external_exports.enum(["index", "sessions", "graph", "memories", "all"]),
+    scope: external_exports.enum(["index", "sessions", "graph", "memories", "usage", "all"]),
     confirm: external_exports.boolean().describe("Must be true; this cannot be undone")
   },
   handler: async (args, ctx) => {
@@ -58533,7 +59095,10 @@ var emSearch = defineTool({
       }
     }
     const out = formatResults(responses, args.max_tokens ?? ctx.config.search.defaultMaxTokens);
-    const note = mode !== "lexical" && mode !== "regex" && !vectorSearch && ctx.config.embeddings.enabled ? "\n\n(embeddings: model still loading \u2014 lexical results only this time)" : "";
+    let note = mode !== "lexical" && mode !== "regex" && !vectorSearch && ctx.config.embeddings.enabled ? "\n\n(embeddings: model still loading \u2014 lexical results only this time)" : "";
+    const sources = Array.isArray(args.source) ? args.source : args.source ? [args.source] : [];
+    if (mode === "semantic" && !ctx.config.docs.embed && sources.some((s) => s.startsWith("docs:")) && responses.every((r) => r.hits.length === 0))
+      note += '\n\n(docs:* pages are indexed without vectors because docs.embed is off; use mode "hybrid" or "lexical", or set docs.embed: true in eminiar.config.json and em_docs {action:"sync", force:true})';
     recordStat(ctx, "em_search", {
       rawChars: responses.reduce(
         (a, r) => a + r.hits.reduce((b, h) => b + h.chunk.body.length, 0),
@@ -58552,6 +59117,7 @@ init_esm_shims();
 // src/session/recall.ts
 init_esm_shims();
 init_ids();
+init_metrics();
 init_model();
 var RECALL_CATEGORY = "recall";
 function recallStats(events) {
@@ -58632,8 +59198,8 @@ var top = (m, n = 4) => Object.entries(m).sort((a, b) => b[1] - a[1]).slice(0, n
 function formatRoutingStats(title, s) {
   if (!s.decisions) return `${title}: no routing decisions recorded yet`;
   const tools2 = Object.entries(s.byTool).sort((a, b) => b[1].calls - a[1].calls).map(([tool, r]) => {
-    const pct = Math.round(100 * r.denied / r.calls);
-    const parts = [`${tool} ${r.denied}/${r.calls} denied (${pct}%)`];
+    const pct3 = Math.round(100 * r.denied / r.calls);
+    const parts = [`${tool} ${r.denied}/${r.calls} denied (${pct3}%)`];
     if (r.annotated) parts.push(`${r.annotated} annotated`);
     return parts.join(", ");
   });
@@ -58649,6 +59215,1787 @@ function formatRoutingStats(title, s) {
   return lines.join("\n");
 }
 
+// src/usage/brief.ts
+init_esm_shims();
+
+// src/usage/aggregate.ts
+init_esm_shims();
+
+// src/usage/blocks.ts
+init_esm_shims();
+var HOUR = 36e5;
+function floorToHour(ts) {
+  return Math.floor(ts / HOUR) * HOUR;
+}
+function newBlock(call, hours) {
+  const start = floorToHour(call.ts);
+  return {
+    id: new Date(start).toISOString(),
+    start,
+    end: start + hours * HOUR,
+    firstCall: call.ts,
+    lastCall: call.ts,
+    calls: 0,
+    tokens: { input: 0, output: 0, cacheCreate: 0, cacheRead: 0 },
+    costUsd: 0,
+    pricedCalls: 0,
+    unpricedCalls: 0,
+    models: [],
+    active: false
+  };
+}
+function addCall(block, call) {
+  block.calls += 1;
+  block.lastCall = Math.max(block.lastCall, call.ts);
+  block.tokens.input += call.input_tokens || 0;
+  block.tokens.output += call.output_tokens || 0;
+  block.tokens.cacheCreate += (call.cache_create_5m || 0) + (call.cache_create_1h || 0);
+  block.tokens.cacheRead += call.cache_read || 0;
+  if (call.priced && call.cost_usd != null && Number.isFinite(call.cost_usd)) {
+    block.costUsd += call.cost_usd;
+    block.pricedCalls += 1;
+  } else {
+    block.unpricedCalls += 1;
+  }
+  if (call.model && !block.models.includes(call.model)) block.models.push(call.model);
+}
+function billingBlocks(calls, now = Date.now(), hours = 5) {
+  const sorted = calls.filter((c) => Number.isFinite(c.ts) && c.model !== "<synthetic>").slice().sort((a, b) => a.ts - b.ts);
+  const blocks = [];
+  let current;
+  for (const call of sorted) {
+    if (!current || call.ts >= current.end) {
+      const next = newBlock(call, hours);
+      if (current) next.gapBefore = Math.max(0, call.ts - current.lastCall);
+      blocks.push(next);
+      current = next;
+    }
+    addCall(current, call);
+  }
+  for (const b of blocks) {
+    b.models.sort();
+    b.active = now >= b.start && now < b.end;
+  }
+  return blocks;
+}
+function activeBlock(blocks, now = Date.now()) {
+  return blocks.find((b) => now >= b.start && now < b.end);
+}
+
+// src/usage/pricing.ts
+init_esm_shims();
+var WEB_SEARCH_PER_1K = 10;
+function price(input2, output2, cacheRead, extra = {}) {
+  return {
+    input: input2,
+    output: output2,
+    cacheWrite5m: input2 * 1.25,
+    cacheWrite1h: input2 * 2,
+    cacheRead,
+    webSearch: WEB_SEARCH_PER_1K,
+    ...extra
+  };
+}
+var FABLE_5_1 = price(10, 50, 0.25);
+var FABLE_5 = price(10, 50, 1);
+var OPUS_5_5 = price(4, 20, 0.2);
+var OPUS_5 = price(5, 25, 0.5);
+var OPUS_4_LATE = price(5, 25, 0.5);
+var OPUS_4_EARLY = price(15, 75, 1.5);
+var SONNET_5_5 = price(2, 10, 0.1);
+var SONNET_5 = price(2, 10, 0.2);
+var SONNET_4 = price(3, 15, 0.3);
+var HAIKU_5_5 = price(0.1, 0.5, 0.01, {
+  longContext: { threshold: 1e5, input: 0.5, output: 2.5 }
+});
+var HAIKU_4_5 = price(1, 5, 0.1);
+var HAIKU_3_5 = price(0.8, 4, 0.08);
+var FAMILIES = [
+  ["fable-5-1", FABLE_5_1],
+  ["mythos-5-1", FABLE_5_1],
+  ["fable-5", FABLE_5],
+  ["mythos-5", FABLE_5],
+  ["opus-5-5", OPUS_5_5],
+  ["opus-5", OPUS_5],
+  ["opus-4-8", OPUS_4_LATE],
+  ["opus-4-7", OPUS_4_LATE],
+  ["opus-4-6", OPUS_4_LATE],
+  ["opus-4-5", OPUS_4_LATE],
+  ["opus-4-1", OPUS_4_EARLY],
+  ["opus-4", OPUS_4_EARLY],
+  ["sonnet-5-5", SONNET_5_5],
+  ["sonnet-5", SONNET_5],
+  ["sonnet-4-6", SONNET_4],
+  ["sonnet-4-5", SONNET_4],
+  ["sonnet-4", SONNET_4],
+  ["haiku-5-5", HAIKU_5_5],
+  ["haiku-4-5", HAIKU_4_5],
+  ["3-5-haiku", HAIKU_3_5]
+];
+var ALIASES = [
+  ["fable", FABLE_5_1],
+  ["mythos", FABLE_5_1],
+  ["opus", OPUS_5_5],
+  ["sonnet", SONNET_5_5],
+  ["haiku", HAIKU_4_5]
+];
+function bundledPrice(id) {
+  for (const [pattern2, p] of FAMILIES) if (id.includes(pattern2)) return p;
+  if (/\d/.test(id)) return void 0;
+  for (const [pattern2, p] of ALIASES) if (id.includes(pattern2)) return p;
+  return void 0;
+}
+function finite(n) {
+  return typeof n === "number" && Number.isFinite(n) && n >= 0;
+}
+function resolvePrice(model, overrides) {
+  const id = String(model ?? "").toLowerCase();
+  if (!id) return void 0;
+  const base = bundledPrice(id);
+  if (!overrides) return base;
+  for (const [pattern2, o] of Object.entries(overrides)) {
+    if (!pattern2 || !id.includes(pattern2.toLowerCase())) continue;
+    const input2 = finite(o.input) ? o.input : base?.input;
+    const output2 = finite(o.output) ? o.output : base?.output;
+    if (input2 === void 0 || output2 === void 0) return base;
+    const merged = {
+      input: input2,
+      output: output2,
+      cacheWrite5m: finite(o.cacheWrite5m) ? o.cacheWrite5m : base && !finite(o.input) ? base.cacheWrite5m : input2 * 1.25,
+      cacheWrite1h: finite(o.cacheWrite1h) ? o.cacheWrite1h : base && !finite(o.input) ? base.cacheWrite1h : input2 * 2,
+      cacheRead: finite(o.cacheRead) ? o.cacheRead : base && !finite(o.input) ? base.cacheRead : input2 * 0.1,
+      webSearch: finite(o.webSearch) ? o.webSearch : base?.webSearch ?? WEB_SEARCH_PER_1K
+    };
+    if (o.longContext) merged.longContext = o.longContext;
+    else if (base?.longContext) merged.longContext = base.longContext;
+    return merged;
+  }
+  return base;
+}
+var tok = (n) => finite(n) ? n : 0;
+function costOfCall(call, price2) {
+  const input2 = tok(call.input_tokens);
+  const output2 = tok(call.output_tokens);
+  const c5m = tok(call.cache_create_5m);
+  const c1h = tok(call.cache_create_1h);
+  const read2 = tok(call.cache_read);
+  const searches = tok(call.web_searches);
+  let p = price2;
+  const lc = price2.longContext;
+  if (lc && input2 + c5m + c1h + read2 > lc.threshold) {
+    const ratio = price2.input > 0 ? lc.input / price2.input : 1;
+    p = {
+      ...price2,
+      input: lc.input,
+      output: lc.output,
+      cacheWrite5m: price2.cacheWrite5m * ratio,
+      cacheWrite1h: price2.cacheWrite1h * ratio,
+      cacheRead: price2.cacheRead * ratio
+    };
+  }
+  const M = 1e6;
+  const breakdown = {
+    input: input2 * p.input / M,
+    output: output2 * p.output / M,
+    cacheWrite: (c5m * p.cacheWrite5m + c1h * p.cacheWrite1h) / M,
+    cacheRead: read2 * p.cacheRead / M,
+    tools: searches / 1e3 * (p.webSearch ?? 0)
+  };
+  return {
+    ...breakdown,
+    total: breakdown.input + breakdown.output + breakdown.cacheWrite + breakdown.cacheRead + breakdown.tools
+  };
+}
+function formatUsd(n) {
+  if (!Number.isFinite(n) || n === 0) return "$0.00";
+  const sign = n < 0 ? "-" : "";
+  const v = Math.abs(n);
+  if (v < 1e-4) return sign ? "-$0.0001" : "<$0.0001";
+  if (v < 1) {
+    const fixed = v.toFixed(4);
+    if (fixed.startsWith("1")) return `${sign}$1.00`;
+    return `${sign}$${fixed.replace(/0+$/, "").replace(/\.(\d)$/, ".$10")}`;
+  }
+  const two = v.toFixed(2);
+  if (Number(two) >= 1e3) return `${sign}$${Math.round(v).toLocaleString("en-US")}`;
+  return `${sign}$${two}`;
+}
+function estTokensFromChars(chars) {
+  return finite(chars) ? Math.ceil(chars / 4) : 0;
+}
+
+// src/usage/aggregate.ts
+var num2 = (n) => typeof n === "number" && Number.isFinite(n) ? n : 0;
+var isRealCall = (c) => c.model !== "<synthetic>";
+function totals(calls) {
+  const t = {
+    calls: 0,
+    input: 0,
+    output: 0,
+    cacheCreate5m: 0,
+    cacheCreate1h: 0,
+    cacheRead: 0,
+    thinking: 0,
+    costUsd: 0,
+    unpricedCalls: 0,
+    cacheHitRate: 0,
+    models: {}
+  };
+  for (const c of calls) {
+    if (!isRealCall(c)) continue;
+    t.calls += 1;
+    t.input += num2(c.input_tokens);
+    t.output += num2(c.output_tokens);
+    t.cacheCreate5m += num2(c.cache_create_5m);
+    t.cacheCreate1h += num2(c.cache_create_1h);
+    t.cacheRead += num2(c.cache_read);
+    t.thinking += num2(c.thinking_tokens);
+    if (c.priced && c.cost_usd != null && Number.isFinite(c.cost_usd)) t.costUsd += c.cost_usd;
+    else t.unpricedCalls += 1;
+    const m = c.model || "unknown";
+    t.models[m] = (t.models[m] ?? 0) + 1;
+  }
+  const denom = t.input + t.cacheCreate5m + t.cacheCreate1h + t.cacheRead;
+  t.cacheHitRate = denom > 0 ? t.cacheRead / denom : 0;
+  return t;
+}
+function groupBy(calls, keyFn) {
+  const buckets = /* @__PURE__ */ new Map();
+  for (const c of calls) {
+    if (!isRealCall(c)) continue;
+    const k = keyFn(c);
+    if (k == null) continue;
+    const list2 = buckets.get(k);
+    if (list2) list2.push(c);
+    else buckets.set(k, [c]);
+  }
+  return [...buckets.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([key, rows]) => ({ key, totals: totals(rows) }));
+}
+var fmtCache = /* @__PURE__ */ new Map();
+function formatter(tz) {
+  const key = tz ?? "";
+  let f = fmtCache.get(key);
+  if (!f) {
+    f = new Intl.DateTimeFormat("en-CA", {
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      ...tz ? { timeZone: tz } : {}
+    });
+    fmtCache.set(key, f);
+  }
+  return f;
+}
+function localYmd(ts, tz) {
+  const parts = formatter(tz).formatToParts(new Date(ts));
+  const get = (type) => Number(parts.find((p) => p.type === type)?.value ?? 0);
+  return { y: get("year"), m: get("month"), d: get("day") };
+}
+var pad2 = (n) => String(n).padStart(2, "0");
+var ymdKey = ({ y, m, d }) => `${y}-${pad2(m)}-${pad2(d)}`;
+function dayKey(ts, tz) {
+  return ymdKey(localYmd(ts, tz));
+}
+function weekKey(ts, tz) {
+  const { y, m, d } = localYmd(ts, tz);
+  const date5 = new Date(Date.UTC(y, m - 1, d));
+  const back = (date5.getUTCDay() + 6) % 7;
+  date5.setUTCDate(date5.getUTCDate() - back);
+  return ymdKey({ y: date5.getUTCFullYear(), m: date5.getUTCMonth() + 1, d: date5.getUTCDate() });
+}
+function monthKey(ts, tz) {
+  const { y, m } = localYmd(ts, tz);
+  return `${y}-${pad2(m)}`;
+}
+var byModel = (calls) => groupBy(calls, (c) => c.model || "unknown");
+var bySession = (calls) => groupBy(calls, (c) => c.session_id);
+var byEffort = (calls) => groupBy(calls, (c) => c.effort || "default");
+var bySpeed = (calls) => groupBy(calls, (c) => c.speed === "fast" ? "fast" : "standard");
+function byAgent(calls) {
+  const mainRows = calls.filter((c) => !c.sidechain);
+  const side = calls.filter((c) => !!c.sidechain);
+  const main = totals(mainRows);
+  const subagents = groupBy(side, (c) => c.agent_id || "unknown").map((g) => ({ agentId: g.key, totals: g.totals })).sort((a, b) => b.totals.costUsd - a.totals.costUsd || b.totals.calls - a.totals.calls);
+  const subCost = subagents.reduce((s, a) => s + a.totals.costUsd, 0);
+  const total = main.costUsd + subCost;
+  return { main, subagents, delegationShare: total > 0 ? subCost / total : 0 };
+}
+function cacheStats(calls) {
+  const t = totals(calls);
+  const writes = t.cacheCreate5m + t.cacheCreate1h;
+  const first = /* @__PURE__ */ new Map();
+  for (const c of calls) {
+    if (!isRealCall(c)) continue;
+    const prev = first.get(c.session_id);
+    if (!prev || c.ts < prev.ts || c.ts === prev.ts && c.request_id < prev.request_id)
+      first.set(c.session_id, c);
+  }
+  let coldCalls = 0;
+  for (const c of calls) {
+    if (!isRealCall(c) || first.get(c.session_id) === c) continue;
+    if (num2(c.cache_read) === 0) coldCalls += 1;
+  }
+  return {
+    hitRate: t.cacheHitRate,
+    cacheWrites: writes,
+    cacheReads: t.cacheRead,
+    writeReadRatio: t.cacheRead > 0 ? writes / t.cacheRead : 0,
+    share1h: writes > 0 ? t.cacheCreate1h / writes : 0,
+    coldCalls,
+    calls: t.calls
+  };
+}
+function contextTimeline(sessionCalls, contextEvents = []) {
+  const points = sessionCalls.filter(isRealCall).sort((a, b) => a.ts - b.ts).map((c) => ({
+    ts: c.ts,
+    requestId: c.request_id,
+    model: c.model,
+    contextTokens: num2(c.input_tokens) + num2(c.cache_create_5m) + num2(c.cache_create_1h) + num2(c.cache_read),
+    output: num2(c.output_tokens),
+    costUsd: c.cost_usd != null && Number.isFinite(c.cost_usd) ? c.cost_usd : 0
+  }));
+  const events = contextEvents.slice().sort((a, b) => a.ts - b.ts);
+  let i = 0;
+  for (const ev2 of events) {
+    while (i < points.length && points[i].ts < ev2.ts) i += 1;
+    const p = points[i];
+    if (p) p.compactBefore = true;
+  }
+  return points;
+}
+var BURN_MIN_MINUTES = 5;
+var BURN_MIN_CALLS = 2;
+function burnRate(calls, now = Date.now()) {
+  const none = {
+    tokensPerMin: 0,
+    usdPerHour: 0,
+    projectedBlockUsd: null,
+    windowMinutes: 0,
+    reliable: false
+  };
+  const block = activeBlock(billingBlocks(calls, now), now);
+  if (!block) return none;
+  const windowMinutes = Math.max(0, (Math.min(now, block.end) - block.firstCall) / 6e4);
+  if (windowMinutes < BURN_MIN_MINUTES || block.calls < BURN_MIN_CALLS)
+    return { ...none, windowMinutes };
+  const tokens = block.tokens.input + block.tokens.output + block.tokens.cacheCreate + block.tokens.cacheRead;
+  const usdPerHour = block.costUsd / windowMinutes * 60;
+  const remainingHours = Math.max(0, block.end - now) / 36e5;
+  return {
+    tokensPerMin: tokens / windowMinutes,
+    usdPerHour,
+    projectedBlockUsd: block.costUsd + usdPerHour * remainingHours,
+    windowMinutes,
+    reliable: true
+  };
+}
+function topToolConsumers(toolUses, limit = 10) {
+  const byTool = /* @__PURE__ */ new Map();
+  for (const u of toolUses) {
+    const tool = u.tool || "unknown";
+    let row = byTool.get(tool);
+    if (!row) {
+      row = { tool, calls: 0, chars: 0, estTokens: 0, avgChars: 0, errors: 0 };
+      byTool.set(tool, row);
+    }
+    row.calls += 1;
+    row.chars += num2(u.result_chars);
+    if (u.is_error) row.errors += 1;
+  }
+  return [...byTool.values()].map((r) => ({
+    ...r,
+    estTokens: estTokensFromChars(r.chars),
+    avgChars: r.calls > 0 ? Math.round(r.chars / r.calls) : 0
+  })).sort((a, b) => b.chars - a.chars || b.calls - a.calls || a.tool.localeCompare(b.tool)).slice(0, Math.max(0, limit));
+}
+
+// src/usage/insights.ts
+init_esm_shims();
+
+// src/usage/savings.ts
+init_esm_shims();
+var FALLBACK_MODEL = "claude-sonnet-5-5";
+function dominantModel(calls) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const c of calls) {
+    if (!c.model) continue;
+    counts.set(c.model, (counts.get(c.model) ?? 0) + 1);
+  }
+  let best;
+  let bestN = 0;
+  for (const [m, n] of counts) {
+    if (n > bestN) {
+      best = m;
+      bestN = n;
+    }
+  }
+  return best;
+}
+function pricedSavings(stats, calls, overrides, opts = {}) {
+  const assumptions = [
+    "Saved tokens = ceil(raw_chars / 4) - ceil(returned_chars / 4) per stat row, floored at 0 (same estimate as em_stats).",
+    "Direct savings price saved tokens at the 5-minute cache-write rate: a tool result enters context once and is written to cache on that turn.",
+    "Compounding savings price saved tokens at the cache-read rate once per later API call in the same session; stat rows carry no timestamps, so half of the session's calls are taken as the expected number of later calls.",
+    "Sessions with no recorded API calls earn no compounding savings."
+  ];
+  const global2 = dominantModel(calls);
+  let fallbackUsed = false;
+  const priceFor = (model2) => {
+    const m = model2 ?? global2;
+    const p = m ? resolvePrice(m, overrides) : void 0;
+    if (m && p) return { model: m, price: p };
+    fallbackUsed = true;
+    const fb = resolvePrice(FALLBACK_MODEL, overrides) ?? resolvePrice(FALLBACK_MODEL);
+    return { model: FALLBACK_MODEL, price: fb };
+  };
+  const bySession2 = /* @__PURE__ */ new Map();
+  for (const c of calls) {
+    const list2 = bySession2.get(c.session_id);
+    if (list2) list2.push(c);
+    else bySession2.set(c.session_id, [c]);
+  }
+  const sessionModel = /* @__PURE__ */ new Map();
+  for (const [sid, rows] of bySession2) sessionModel.set(sid, dominantModel(rows));
+  const windowed = opts.since !== void 0;
+  assumptions.push(
+    windowed ? `Savings cover sessions active in the window (since ${new Date(opts.since).toISOString()}): stat rows carry no timestamps, so rows of sessions without an API call in the window are left out.` : "All-time: every stat row of the project is counted."
+  );
+  let savedTokens = 0;
+  let directUsd = 0;
+  let compoundingUsd = 0;
+  const laterBySession = /* @__PURE__ */ new Map();
+  for (const row of stats) {
+    if (windowed && !bySession2.has(row.session_id)) continue;
+    const saved = Math.max(
+      0,
+      estTokensFromChars(row.raw_chars) - estTokensFromChars(row.returned_chars)
+    );
+    if (saved === 0) continue;
+    savedTokens += saved;
+    const { price: price2 } = priceFor(sessionModel.get(row.session_id));
+    directUsd += saved * price2.cacheWrite5m / 1e6;
+    const later = (bySession2.get(row.session_id)?.length ?? 0) / 2;
+    laterBySession.set(row.session_id, later);
+    compoundingUsd += saved * price2.cacheRead * later / 1e6;
+  }
+  const laterValues = [...laterBySession.values()];
+  const laterCallsPerSession = laterValues.length > 0 ? laterValues.reduce((a, b) => a + b, 0) / laterValues.length : 0;
+  const model = global2 ?? FALLBACK_MODEL;
+  if (!global2) assumptions.push(`No API calls recorded; priced at ${FALLBACK_MODEL} list prices.`);
+  else
+    assumptions.push(
+      `Each session is priced at its own dominant model (by calls); ${model} overall.`
+    );
+  if (fallbackUsed && global2)
+    assumptions.push(`Some sessions had no priceable model and were priced at ${FALLBACK_MODEL}.`);
+  return { savedTokens, directUsd, compoundingUsd, laterCallsPerSession, model, assumptions };
+}
+
+// src/usage/insights.ts
+var THRASH_WRITE_SHARE = 0.2;
+var THRASH_RUN = 3;
+var TTL_5M_MS = 5 * 6e4;
+var TTL_1H_MS = 60 * 6e4;
+var COLD_WRITE_SHARE = 0.5;
+var BLOAT_TOKENS = 8e3;
+var BLOAT_TOOLS = /* @__PURE__ */ new Set(["Read", "Bash", "Grep", "WebFetch", "Glob"]);
+var CHURN_COMPACTIONS = 3;
+var CHURN_EARLY_SHARE = 0.5;
+var DEFAULT_WINDOW = 2e5;
+var TRIVIAL_OUTPUT = 100;
+var TRIVIAL_SHARE = 0.3;
+var MIN_PREMIUM_CALLS = 5;
+var FAST_COST_SHARE = 0.25;
+var THINKING_SHARE = 0.4;
+var MIN_OUTPUT_FOR_THINKING = 1e3;
+var DELEGATION_SHARE = 0.6;
+var DEFAULT_TURN_USD = 1;
+var ERROR_RUN = 3;
+var NEAR_LIMIT_PCT = 85;
+var NEAR_LIMIT_HIGH = 95;
+var num3 = (n) => typeof n === "number" && Number.isFinite(n) ? n : 0;
+var pct = (x) => `${Math.round(x * 100)}%`;
+var usd = (n) => n >= 1 ? `$${n.toFixed(2)}` : `$${n.toFixed(3)}`;
+var round4 = (n) => Math.round(n * 1e4) / 1e4;
+var clamp = (n) => Math.max(0, Math.min(100, Math.round(n)));
+var fmtK = (n) => n >= 1e6 ? `${(n / 1e6).toFixed(1)}M` : n >= 1e3 ? `${Math.round(n / 1e3)}k` : `${n}`;
+var contextOf = (c) => num3(c.input_tokens) + num3(c.cache_create_5m) + num3(c.cache_create_1h) + num3(c.cache_read);
+var writesOf = (c) => num3(c.cache_create_5m) + num3(c.cache_create_1h);
+var costOf = (c) => c.priced && c.cost_usd != null && Number.isFinite(c.cost_usd) ? c.cost_usd : 0;
+var isPremium = (model) => /opus|fable|mythos/i.test(model);
+function threads(calls) {
+  const out = /* @__PURE__ */ new Map();
+  for (const c of calls) {
+    const key = `${c.session_id}\0${c.sidechain ? c.agent_id ?? "sidechain" : ""}`;
+    const list2 = out.get(key);
+    if (list2) list2.push(c);
+    else out.set(key, [c]);
+  }
+  for (const list2 of out.values()) list2.sort((a, b) => a.ts - b.ts);
+  return out;
+}
+function groupBySession(rows) {
+  const out = /* @__PURE__ */ new Map();
+  for (const r of rows) {
+    const list2 = out.get(r.session_id);
+    if (list2) list2.push(r);
+    else out.set(r.session_id, [r]);
+  }
+  return out;
+}
+function dominantModel2(calls) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const c of calls) counts.set(c.model, (counts.get(c.model) ?? 0) + 1);
+  let best;
+  let n = 0;
+  for (const [m, k] of counts)
+    if (k > n) {
+      best = m;
+      n = k;
+    }
+  return best;
+}
+function writePrice(c, p) {
+  return num3(c.cache_create_1h) > num3(c.cache_create_5m) ? p.cacheWrite1h : p.cacheWrite5m;
+}
+function scopeFor(sessionIds) {
+  const ids = [...new Set(sessionIds)];
+  return ids.length === 1 ? { scope: "session", sessionId: ids[0] } : { scope: "project" };
+}
+function withScope(base, sessionIds) {
+  const s = scopeFor(sessionIds);
+  const out = { ...base, scope: s.scope };
+  if (s.sessionId) out.sessionId = s.sessionId;
+  return out;
+}
+var SEVERITY_RANK = { high: 0, warn: 1, info: 2 };
+function hasCompactionBetween(ctx, sessionId, from, to) {
+  const list2 = ctx.compactionsBySession.get(sessionId);
+  if (!list2) return false;
+  return list2.some((t) => t > from && t <= to);
+}
+function detectCacheThrash(ctx) {
+  let runs = 0;
+  let longest = 0;
+  let rewritten = 0;
+  let savings = 0;
+  const sessions = /* @__PURE__ */ new Set();
+  for (const list2 of ctx.threads.values()) {
+    let run = [];
+    const flush = () => {
+      if (run.length >= THRASH_RUN) {
+        runs += 1;
+        longest = Math.max(longest, run.length);
+        for (const c of run) {
+          const w = writesOf(c);
+          rewritten += w;
+          sessions.add(c.session_id);
+          const p = ctx.priceOf(c.model);
+          if (p) savings += w * (writePrice(c, p) - p.cacheRead) / 1e6;
+        }
+      }
+      run = [];
+    };
+    for (let i = 1; i < list2.length; i++) {
+      const c = list2[i];
+      const prev = list2[i - 1];
+      const ctxTokens = contextOf(c);
+      const heavy = ctxTokens > 0 && writesOf(c) / ctxTokens >= THRASH_WRITE_SHARE;
+      const broken = hasCompactionBetween(ctx, c.session_id, prev.ts, c.ts) || c.ts - prev.ts > ttlFor(list2);
+      if (!heavy || broken) {
+        flush();
+        continue;
+      }
+      run.push(c);
+    }
+    flush();
+  }
+  if (runs === 0) return void 0;
+  return withScope(
+    {
+      id: "cache-thrash",
+      severity: runs >= 3 || rewritten >= 5e5 ? "high" : "warn",
+      title: "Prompt cache keeps being rewritten",
+      reason: `${runs} run${runs === 1 ? "" : "s"} of ${THRASH_RUN}+ consecutive calls rewrote \u2265 ${pct(THRASH_WRITE_SHARE)} of their context (longest run ${longest} calls, ${fmtK(rewritten)} tokens written again).`,
+      evidence: { runs, longestRun: longest, tokensRewritten: rewritten },
+      estimatedSavingsUsd: round4(savings),
+      recommendation: "Something early in the prompt changes every turn (system prompt, tool list, a file re-read with a timestamp); keep the stable prefix stable so later calls hit the cache."
+    },
+    sessions
+  );
+}
+function ttlFor(list2) {
+  let w5 = 0;
+  let w1 = 0;
+  for (const c of list2) {
+    w5 += num3(c.cache_create_5m);
+    w1 += num3(c.cache_create_1h);
+  }
+  return w1 > w5 ? TTL_1H_MS : TTL_5M_MS;
+}
+function detectCacheCold(ctx) {
+  let restarts = 0;
+  let rewritten = 0;
+  let savings = 0;
+  let longestGap = 0;
+  const sessions = /* @__PURE__ */ new Set();
+  for (const list2 of ctx.threads.values()) {
+    const ttl = ttlFor(list2);
+    for (let i = 1; i < list2.length; i++) {
+      const c = list2[i];
+      const prev = list2[i - 1];
+      const gap = c.ts - prev.ts;
+      if (gap <= ttl) continue;
+      if (hasCompactionBetween(ctx, c.session_id, prev.ts, c.ts)) continue;
+      const ctxTokens = contextOf(c);
+      const w = writesOf(c);
+      if (ctxTokens === 0 || w / ctxTokens < COLD_WRITE_SHARE) continue;
+      restarts += 1;
+      rewritten += w;
+      longestGap = Math.max(longestGap, gap);
+      sessions.add(c.session_id);
+      const p = ctx.priceOf(c.model);
+      if (p) savings += w * (writePrice(c, p) - p.cacheRead) / 1e6;
+    }
+  }
+  if (restarts === 0) return void 0;
+  const minutes = Math.round(longestGap / 6e4);
+  return withScope(
+    {
+      id: "cache-cold",
+      severity: restarts >= 2 ? "warn" : "info",
+      title: `Cache went cold ${restarts === 1 ? "once" : `${restarts} times`}`,
+      reason: `${restarts} pause${restarts === 1 ? "" : "s"} longer than the cache TTL (longest ${minutes} min) forced ${fmtK(rewritten)} tokens to be written to cache again (~${usd(savings)}).`,
+      evidence: { restarts, tokensRewritten: rewritten, longestGapMinutes: minutes },
+      estimatedSavingsUsd: round4(savings),
+      recommendation: "Long pauses mid-session re-pay the cache write; for walk-away breaks start a new session, or keep the turn cadence inside the TTL."
+    },
+    sessions
+  );
+}
+function detectContextBloat(ctx) {
+  const bySession2 = groupBySession(ctx.calls);
+  const modelFor = /* @__PURE__ */ new Map();
+  for (const [sid, rows] of bySession2) modelFor.set(sid, dominantModel2(rows));
+  let count = 0;
+  let tokens = 0;
+  let savings = 0;
+  const byTool = /* @__PURE__ */ new Map();
+  const sessions = /* @__PURE__ */ new Set();
+  for (const u of ctx.toolUses) {
+    if (!BLOAT_TOOLS.has(u.tool)) continue;
+    const est = estTokensFromChars(num3(u.result_chars));
+    if (est <= BLOAT_TOKENS) continue;
+    count += 1;
+    tokens += est;
+    byTool.set(u.tool, (byTool.get(u.tool) ?? 0) + 1);
+    sessions.add(u.session_id);
+    const p = ctx.priceOf(modelFor.get(u.session_id) ?? FALLBACK_MODEL) ?? ctx.priceOf(FALLBACK_MODEL);
+    if (p) {
+      const later = ctx.laterCalls(u.session_id, u.ts);
+      savings += (est * p.cacheWrite5m + est * p.cacheRead * later) / 1e6;
+    }
+  }
+  if (count === 0) return void 0;
+  const top2 = [...byTool.entries()].sort((a, b) => b[1] - a[1])[0];
+  return withScope(
+    {
+      id: "context-bloat",
+      severity: count >= 5 || tokens >= 1e5 ? "high" : "warn",
+      title: "Oversized tool results in context",
+      reason: `${count} ${[...byTool.keys()].join("/")} result${count === 1 ? "" : "s"} above ${fmtK(BLOAT_TOKENS)} tokens put ~${fmtK(tokens)} tokens into context (mostly ${top2[0]}, ${top2[1]}\xD7), re-read on every later call.`,
+      evidence: { results: count, estTokens: tokens, topTool: top2[0], topToolCount: top2[1] },
+      estimatedSavingsUsd: round4(savings),
+      recommendation: "Route large outputs through em_execute / em_execute_file / em_search so only the matching sections come back."
+    },
+    sessions
+  );
+}
+function detectCompactionChurn(ctx) {
+  const windowFor = /* @__PURE__ */ new Map();
+  for (const s of ctx.snapshots) {
+    if (num3(s.ctx_size) > 0) {
+      const prev = windowFor.get(s.session_id);
+      if (prev === void 0) windowFor.set(s.session_id, num3(s.ctx_size));
+    }
+  }
+  let worstSession;
+  let worstCount = 0;
+  let early = 0;
+  const sessions = /* @__PURE__ */ new Set();
+  for (const [sid, evs] of groupBySession(ctx.contextEvents)) {
+    const compactions = evs.filter((e) => e.kind === "compact");
+    const window2 = windowFor.get(sid) ?? DEFAULT_WINDOW;
+    const earlyHere = compactions.filter(
+      (e) => e.pre_tokens != null && e.pre_tokens > 0 && e.pre_tokens < window2 * CHURN_EARLY_SHARE
+    ).length;
+    if (compactions.length >= CHURN_COMPACTIONS || earlyHere > 0) {
+      sessions.add(sid);
+      early += earlyHere;
+      if (compactions.length > worstCount) {
+        worstCount = compactions.length;
+        worstSession = sid;
+      }
+    }
+  }
+  if (sessions.size === 0) return void 0;
+  return withScope(
+    {
+      id: "compaction-churn",
+      severity: worstCount >= CHURN_COMPACTIONS * 2 ? "high" : "warn",
+      title: "Frequent context compactions",
+      reason: `${sessions.size} session${sessions.size === 1 ? "" : "s"} compacted repeatedly (up to ${worstCount} times in ${(worstSession ?? "").slice(0, 8)}; ${early} below ${pct(CHURN_EARLY_SHARE)} of the window).`,
+      evidence: { sessions: sessions.size, maxCompactions: worstCount, earlyCompactions: early },
+      recommendation: "Each compaction rewrites the whole cache and loses detail; keep raw output out of context (em_* tools) and split long tasks into sessions."
+    },
+    sessions
+  );
+}
+function detectOpusForTrivial(ctx) {
+  const toolRequests = /* @__PURE__ */ new Set();
+  for (const u of ctx.toolUses) if (u.request_id) toolRequests.add(u.request_id);
+  const premium = ctx.calls.filter((c) => isPremium(c.model));
+  if (premium.length < MIN_PREMIUM_CALLS) return void 0;
+  const trivial = premium.filter(
+    (c) => num3(c.output_tokens) < TRIVIAL_OUTPUT && c.stop_reason !== "tool_use" && !toolRequests.has(c.request_id)
+  );
+  const share2 = trivial.length / premium.length;
+  if (share2 <= TRIVIAL_SHARE) return void 0;
+  const sonnet = resolvePrice(FALLBACK_MODEL, ctx.overrides);
+  let spent = 0;
+  let repriced = 0;
+  for (const c of trivial) {
+    spent += costOf(c);
+    if (sonnet) repriced += costOfCall(c, sonnet).total;
+  }
+  const savings = Math.max(0, spent - repriced);
+  return withScope(
+    {
+      id: "opus-for-trivial",
+      severity: share2 >= 0.6 ? "warn" : "info",
+      title: "Premium model on trivial turns",
+      reason: `${trivial.length} of ${premium.length} premium-model calls (${pct(share2)}) produced under ${TRIVIAL_OUTPUT} output tokens with no tool use, costing ${usd(spent)} (~${usd(repriced)} at Sonnet).`,
+      evidence: {
+        trivialCalls: trivial.length,
+        premiumCalls: premium.length,
+        share: Math.round(share2 * 100),
+        spentUsd: round4(spent)
+      },
+      estimatedSavingsUsd: round4(savings),
+      recommendation: "Short acknowledgements and lookups do not need the premium model; delegate routine turns to a Sonnet/Haiku subagent or switch model for simple work."
+    },
+    trivial.map((c) => c.session_id)
+  );
+}
+function detectFastModeShare(ctx) {
+  let fast = 0;
+  let fastCalls = 0;
+  let total = 0;
+  const sessions = /* @__PURE__ */ new Set();
+  for (const c of ctx.calls) {
+    const cost = costOf(c);
+    total += cost;
+    if (c.speed === "fast") {
+      fast += cost;
+      fastCalls += 1;
+      sessions.add(c.session_id);
+    }
+  }
+  if (total <= 0) return void 0;
+  const share2 = fast / total;
+  if (share2 <= FAST_COST_SHARE) return void 0;
+  return withScope(
+    {
+      id: "fast-mode-share",
+      severity: "info",
+      title: "Fast mode is a large share of spend",
+      reason: `${fastCalls} fast-mode calls account for ${usd(fast)} of ${usd(total)} (${pct(share2)}) of priced cost.`,
+      evidence: {
+        fastCalls,
+        fastUsd: round4(fast),
+        totalUsd: round4(total),
+        share: Math.round(share2 * 100)
+      },
+      recommendation: "Fast mode is billed at a premium; reserve it for interactive turns where latency matters."
+    },
+    sessions
+  );
+}
+function detectThinkingShare(ctx) {
+  const t = totals(ctx.calls);
+  if (t.output < MIN_OUTPUT_FOR_THINKING || t.thinking <= 0) return void 0;
+  const share2 = t.thinking / t.output;
+  if (share2 <= THINKING_SHARE) return void 0;
+  return withScope(
+    {
+      id: "thinking-share",
+      severity: "info",
+      title: "Most output tokens are thinking",
+      reason: `${fmtK(t.thinking)} of ${fmtK(t.output)} output tokens (${pct(share2)}) were thinking, billed at the output rate.`,
+      evidence: {
+        thinkingTokens: t.thinking,
+        outputTokens: t.output,
+        share: Math.round(share2 * 100)
+      },
+      recommendation: "Lower the effort level for routine edits and lookups; keep high effort for design and debugging."
+    },
+    ctx.calls.map((c) => c.session_id)
+  );
+}
+function detectSubagentCost(ctx) {
+  const a = byAgent(ctx.calls);
+  if (a.delegationShare <= DELEGATION_SHARE) return void 0;
+  const subCost = a.subagents.reduce((s, x) => s + x.totals.costUsd, 0);
+  const subCalls = a.subagents.reduce((s, x) => s + x.totals.calls, 0);
+  return withScope(
+    {
+      id: "subagent-cost",
+      severity: "info",
+      title: "Subagents dominate spend",
+      reason: `${a.subagents.length} subagent${a.subagents.length === 1 ? "" : "s"} made ${subCalls} calls for ${usd(subCost)}, ${pct(a.delegationShare)} of priced cost (main thread ${usd(a.main.costUsd)}).`,
+      evidence: {
+        subagents: a.subagents.length,
+        subagentCalls: subCalls,
+        subagentUsd: round4(subCost),
+        share: Math.round(a.delegationShare * 100)
+      },
+      recommendation: "Check that subagents run on the cheapest model that fits (model: sonnet/haiku) and return summaries, not transcripts."
+    },
+    ctx.calls.filter((c) => c.sidechain).map((c) => c.session_id)
+  );
+}
+var DRIVER_ADVICE = {
+  "cache-write": {
+    what: "cache writes",
+    recommendation: "Cache writes dominate: a long idle gap or a cache-busting change (edited system prompt, reordered tools) re-wrote the prefix. Keep the prefix stable, or use the 1h cache deliberately for long pauses."
+  },
+  output: {
+    what: "output",
+    recommendation: "Output dominates: a long answer or heavy thinking. Lower the effort level or ask for a shorter answer; keep high effort for design and debugging."
+  },
+  context: {
+    what: "context",
+    recommendation: "Context dominates: the call re-read a large conversation. Compact, start a fresh session, or move the bulk into a subagent."
+  }
+};
+function detectExpensiveTurn(ctx) {
+  const limit = ctx.budgets.turnUsd ?? DEFAULT_TURN_USD;
+  const hits = ctx.calls.filter((c) => costOf(c) > limit).sort((a, b2) => costOf(b2) - costOf(a));
+  if (hits.length === 0) return void 0;
+  const top2 = hits[0];
+  const price2 = ctx.priceOf(top2.model);
+  const b = price2 ? costOfCall(top2, price2) : { input: 0, output: 0, cacheWrite: 0, cacheRead: 0, tools: 0, total: costOf(top2) };
+  const contextUsd = b.input + b.cacheRead;
+  const driver = b.cacheWrite > b.output && b.cacheWrite > contextUsd ? "cache-write" : b.output > contextUsd ? "output" : "context";
+  const advice = DRIVER_ADVICE[driver];
+  const n = hits.length;
+  return withScope(
+    {
+      id: "expensive-turn",
+      severity: costOf(top2) > limit * 3 ? "high" : "warn",
+      title: `${n} call${n === 1 ? "" : "s"} over ${usd(limit)}`,
+      reason: `${n} call${n === 1 ? "" : "s"} cost more than ${usd(limit)} each; the largest was ${usd(costOf(top2))} on ${top2.model} with ${fmtK(contextOf(top2))} context tokens, driven by ${advice.what} (context ${usd(contextUsd)}, output ${usd(b.output)}, cache writes ${usd(b.cacheWrite)}).`,
+      evidence: {
+        calls: n,
+        maxUsd: round4(costOf(top2)),
+        model: top2.model,
+        contextTokens: contextOf(top2),
+        limitUsd: limit,
+        driver,
+        contextUsd: round4(contextUsd),
+        outputUsd: round4(b.output),
+        cacheWriteUsd: round4(b.cacheWrite)
+      },
+      recommendation: advice.recommendation
+    },
+    hits.map((c) => c.session_id)
+  );
+}
+function detectErrorLoop(ctx) {
+  const loops = ctx.events.filter((e) => e.category === "iteration_loop");
+  const sessions = new Set(loops.map((e) => e.session_id));
+  let worstTool = "";
+  let worstRun = 0;
+  const byThread = /* @__PURE__ */ new Map();
+  for (const u of ctx.toolUses) {
+    const key = `${u.session_id}\0${u.agent_id ?? ""}`;
+    const list2 = byThread.get(key);
+    if (list2) list2.push(u);
+    else byThread.set(key, [u]);
+  }
+  for (const list2 of byThread.values()) {
+    list2.sort((a, b) => a.ts - b.ts);
+    let run = 0;
+    let tool = "";
+    for (const u of list2) {
+      if (u.is_error && u.tool === tool) run += 1;
+      else {
+        run = u.is_error ? 1 : 0;
+        tool = u.is_error ? u.tool : "";
+      }
+      if (run >= ERROR_RUN) {
+        sessions.add(u.session_id);
+        if (run > worstRun) {
+          worstRun = run;
+          worstTool = tool;
+        }
+      }
+    }
+  }
+  if (loops.length === 0 && worstRun === 0) return void 0;
+  const parts = [];
+  if (loops.length)
+    parts.push(`${loops.length} repeated-call loop${loops.length === 1 ? "" : "s"} recorded`);
+  if (worstRun) parts.push(`${worstRun} consecutive ${worstTool} failures`);
+  return withScope(
+    {
+      id: "error-loop",
+      severity: "warn",
+      title: "Repeated failures or loops",
+      reason: `${parts.join(" and ")}; every retry re-reads the whole context.`,
+      evidence: { loops: loops.length, longestErrorRun: worstRun, tool: worstTool },
+      recommendation: "After two identical failures stop and change approach (em_recall for an earlier fix, read the error, try a different tool)."
+    },
+    sessions
+  );
+}
+function detectBudget(ctx) {
+  const out = [];
+  const { sessionUsd, dailyUsd } = ctx.budgets;
+  if (sessionUsd) {
+    for (const [sid, rows] of groupBySession(ctx.calls)) {
+      const cost = totals(rows).costUsd;
+      if (cost <= sessionUsd) continue;
+      out.push({
+        id: "budget",
+        severity: "high",
+        title: "Session budget exceeded",
+        reason: `Session ${sid.slice(0, 8)} has cost ${usd(cost)}, over the ${usd(sessionUsd)} session budget (${pct(cost / sessionUsd)}).`,
+        evidence: { sessionUsd: round4(cost), budgetUsd: sessionUsd },
+        scope: "session",
+        sessionId: sid
+      });
+    }
+  }
+  if (dailyUsd) {
+    const today = dayKey(ctx.now);
+    const cost = totals(ctx.calls.filter((c) => dayKey(c.ts) === today)).costUsd;
+    if (cost > dailyUsd)
+      out.push({
+        id: "budget",
+        severity: "high",
+        title: "Daily budget exceeded",
+        reason: `Today (${today}) has cost ${usd(cost)}, over the ${usd(dailyUsd)} daily budget (${pct(cost / dailyUsd)}).`,
+        evidence: { day: today, todayUsd: round4(cost), budgetUsd: dailyUsd },
+        scope: "project"
+      });
+  }
+  return out;
+}
+function detectUnpricedModel(ctx) {
+  const unpriced = ctx.calls.filter((c) => !c.priced);
+  if (unpriced.length === 0) return void 0;
+  const models = [...new Set(unpriced.map((c) => c.model || "unknown"))];
+  return withScope(
+    {
+      id: "unpriced-model",
+      severity: "info",
+      title: "Some calls are unpriced",
+      reason: `${unpriced.length} of ${ctx.calls.length} calls use ${models.length} model${models.length === 1 ? "" : "s"} without a price (${models.slice(0, 3).join(", ")}), so cost totals undercount.`,
+      evidence: { calls: unpriced.length, models: models.join(", ") },
+      recommendation: 'Add the model to config.usage.pricing, e.g. {"pricing": {"<model substring>": {"input": 3, "output": 15}}} (USD per MTok).'
+    },
+    unpriced.map((c) => c.session_id)
+  );
+}
+function detectContextNearLimit(ctx) {
+  let latest;
+  for (const s of ctx.snapshots) if (!latest || s.ts > latest.ts) latest = s;
+  if (!latest || latest.ctx_used_pct == null || latest.ctx_used_pct < NEAR_LIMIT_PCT)
+    return void 0;
+  const p = latest.ctx_used_pct;
+  return {
+    id: "context-near-limit",
+    severity: p >= NEAR_LIMIT_HIGH ? "high" : "warn",
+    title: "Context window nearly full",
+    reason: `The latest statusline reports ${Math.round(p)}% of the ${fmtK(num3(latest.ctx_size) || DEFAULT_WINDOW)}-token window in use; the next compaction is close.`,
+    evidence: { ctxUsedPct: Math.round(p), ctxSize: num3(latest.ctx_size) },
+    recommendation: "Save durable findings with em_remember now, then compact or start a fresh session.",
+    scope: "session",
+    sessionId: latest.session_id
+  };
+}
+function findInsight(insights, id) {
+  return insights.find((i) => i.id === id);
+}
+var ev = (i, key) => {
+  const v = i?.evidence?.[key];
+  return typeof v === "number" ? v : 0;
+};
+function scoreContextHealth(ctx, insights) {
+  const reasons = [];
+  let v = 100;
+  const bloat = ev(findInsight(insights, "context-bloat"), "results");
+  if (bloat) {
+    const d = Math.min(30, bloat * 5);
+    v -= d;
+    reasons.push(`${bloat} oversized tool result${bloat === 1 ? "" : "s"} in context (\u2212${d})`);
+  }
+  let extra = 0;
+  for (const evs of groupBySession(ctx.contextEvents).values())
+    extra += Math.max(0, evs.filter((e) => e.kind === "compact").length - 1);
+  if (extra) {
+    const d = Math.min(30, extra * 10);
+    v -= d;
+    reasons.push(
+      `${extra} compaction${extra === 1 ? "" : "s"} beyond the first per session (\u2212${d})`
+    );
+  }
+  const near = findInsight(insights, "context-near-limit");
+  if (near) {
+    v -= 20;
+    reasons.push(`context ${ev(near, "ctxUsedPct")}% full (\u221220)`);
+  }
+  const loop = findInsight(insights, "error-loop");
+  if (loop) {
+    const n = ev(loop, "loops") + (ev(loop, "longestErrorRun") ? 1 : 0);
+    const d = Math.min(20, n * 10);
+    v -= d;
+    reasons.push(`${n} error loop${n === 1 ? "" : "s"} (\u2212${d})`);
+  }
+  if (!reasons.length)
+    reasons.push(
+      ctx.calls.length ? "no oversized results, compaction churn or loops" : "no usage recorded yet"
+    );
+  return { id: "context-health", value: clamp(v), reasons };
+}
+function scoreCostEfficiency(ctx, insights) {
+  const reasons = [];
+  let v = 100;
+  const trivial = findInsight(insights, "opus-for-trivial");
+  if (trivial) {
+    const d = Math.round(ev(trivial, "share") / 100 * 50);
+    v -= d;
+    reasons.push(`${ev(trivial, "share")}% of premium-model calls were trivial (\u2212${d})`);
+  }
+  const fast = findInsight(insights, "fast-mode-share");
+  if (fast) {
+    const d = Math.round(ev(fast, "share") / 100 * 40);
+    v -= d;
+    reasons.push(`fast mode is ${ev(fast, "share")}% of spend (\u2212${d})`);
+  }
+  const exp = findInsight(insights, "expensive-turn");
+  if (exp) {
+    const n = ev(exp, "calls");
+    const d = Math.min(30, n * 10);
+    v -= d;
+    reasons.push(`${n} call${n === 1 ? "" : "s"} over ${usd(ev(exp, "limitUsd"))} (\u2212${d})`);
+  }
+  const unpriced = findInsight(insights, "unpriced-model");
+  if (unpriced && ctx.calls.length) {
+    const share2 = ev(unpriced, "calls") / ctx.calls.length;
+    const d = Math.round(share2 * 20);
+    v -= d;
+    reasons.push(`${pct(share2)} of calls unpriced (\u2212${d})`);
+  }
+  const budgets = insights.filter((i) => i.id === "budget").length;
+  if (budgets) {
+    const d = Math.min(40, budgets * 20);
+    v -= d;
+    reasons.push(`${budgets} budget${budgets === 1 ? "" : "s"} exceeded (\u2212${d})`);
+  }
+  if (!reasons.length)
+    reasons.push(
+      ctx.calls.length ? "no premium waste, fast-mode or budget issues" : "no usage recorded yet"
+    );
+  return { id: "cost-efficiency", value: clamp(v), reasons };
+}
+function scoreCacheEfficiency(ctx, insights) {
+  const reasons = [];
+  const t = totals(ctx.calls);
+  if (t.calls === 0)
+    return { id: "cache-efficiency", value: 0, reasons: ["no usage recorded yet"] };
+  let v = t.cacheHitRate * 100;
+  reasons.push(`cache hit rate ${pct(t.cacheHitRate)} over ${t.calls} calls`);
+  const cold = ev(findInsight(insights, "cache-cold"), "restarts");
+  if (cold) {
+    const d = Math.min(25, cold * 5);
+    v -= d;
+    reasons.push(`${cold} cold restart${cold === 1 ? "" : "s"} (\u2212${d})`);
+  }
+  const thrash = ev(findInsight(insights, "cache-thrash"), "runs");
+  if (thrash) {
+    const d = Math.min(30, thrash * 10);
+    v -= d;
+    reasons.push(`${thrash} cache-rewrite run${thrash === 1 ? "" : "s"} (\u2212${d})`);
+  }
+  return { id: "cache-efficiency", value: clamp(v), reasons };
+}
+function scoreDelegation(ctx) {
+  const reasons = [];
+  const a = byAgent(ctx.calls);
+  if (ctx.calls.length === 0)
+    return { id: "delegation", value: 0, reasons: ["no usage recorded yet"] };
+  if (a.subagents.length === 0)
+    return {
+      id: "delegation",
+      value: 60,
+      reasons: ["no subagent calls: the main thread carries every tool result itself"]
+    };
+  let v;
+  if (a.delegationShare <= DELEGATION_SHARE) {
+    v = 100;
+    reasons.push(
+      `subagents are ${pct(a.delegationShare)} of cost across ${a.subagents.length} agent${a.subagents.length === 1 ? "" : "s"}`
+    );
+  } else {
+    v = Math.max(20, 100 - 150 * (a.delegationShare - DELEGATION_SHARE));
+    reasons.push(
+      `subagents are ${pct(a.delegationShare)} of cost, above ${pct(DELEGATION_SHARE)} (\u2212${100 - Math.round(v)})`
+    );
+  }
+  const sub = totals(ctx.calls.filter((c) => c.sidechain));
+  if (sub.calls && sub.cacheHitRate < 0.5) {
+    v -= 15;
+    reasons.push(`subagent cache hit rate ${pct(sub.cacheHitRate)} (\u221215)`);
+  }
+  return { id: "delegation", value: clamp(v), reasons };
+}
+function detectInsights(input2) {
+  const calls = input2.calls.filter(isRealCall);
+  const compactionsBySession = /* @__PURE__ */ new Map();
+  for (const e of input2.contextEvents) {
+    const list2 = compactionsBySession.get(e.session_id);
+    if (list2) list2.push(e.ts);
+    else compactionsBySession.set(e.session_id, [e.ts]);
+  }
+  for (const list2 of compactionsBySession.values()) list2.sort((a, b) => a - b);
+  const callTs = /* @__PURE__ */ new Map();
+  for (const [sid, rows] of groupBySession(calls))
+    callTs.set(
+      sid,
+      rows.map((c) => c.ts).sort((a, b) => a - b)
+    );
+  const priceCache = /* @__PURE__ */ new Map();
+  const overrides = input2.overrides;
+  const ctx = {
+    calls,
+    threads: threads(calls),
+    toolUses: input2.toolUses,
+    contextEvents: input2.contextEvents,
+    stats: input2.stats,
+    events: input2.events,
+    snapshots: input2.snapshots,
+    now: input2.now ?? Date.now(),
+    budgets: input2.budgets ?? {},
+    overrides,
+    priceOf: (model) => {
+      if (!priceCache.has(model)) priceCache.set(model, resolvePrice(model, overrides));
+      return priceCache.get(model);
+    },
+    compactionsBySession,
+    laterCalls: (sid, ts) => (callTs.get(sid) ?? []).filter((t) => t > ts).length
+  };
+  const insights = [];
+  const push = (i) => {
+    if (i) insights.push(i);
+  };
+  push(detectCacheThrash(ctx));
+  push(detectCacheCold(ctx));
+  push(detectContextBloat(ctx));
+  push(detectCompactionChurn(ctx));
+  push(detectOpusForTrivial(ctx));
+  push(detectFastModeShare(ctx));
+  push(detectThinkingShare(ctx));
+  push(detectSubagentCost(ctx));
+  push(detectExpensiveTurn(ctx));
+  push(detectErrorLoop(ctx));
+  for (const b of detectBudget(ctx)) push(b);
+  push(detectUnpricedModel(ctx));
+  push(detectContextNearLimit(ctx));
+  insights.sort(
+    (a, b) => SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity] || (b.estimatedSavingsUsd ?? 0) - (a.estimatedSavingsUsd ?? 0) || a.id.localeCompare(b.id)
+  );
+  const scores = [
+    scoreContextHealth(ctx, insights),
+    scoreCostEfficiency(ctx, insights),
+    scoreCacheEfficiency(ctx, insights),
+    scoreDelegation(ctx)
+  ];
+  return { insights, scores };
+}
+var INSIGHT_EVENT_CATEGORIES = ["iteration_loop", "error", "tool_call"];
+function loadInsightInput(db, ctx, opts = {}) {
+  const filter = { sessionId: opts.sessionId, since: opts.since };
+  const usage = ctx.config.usage;
+  return {
+    calls: db.apiCalls(filter),
+    toolUses: db.toolUses(filter),
+    contextEvents: db.contextEvents(filter),
+    snapshots: db.statuslineSnapshots(filter),
+    stats: opts.sessionId ? db.statsBySession(opts.sessionId) : db.statsAll(),
+    events: opts.sessionId ? db.eventsBySession(opts.sessionId, { categories: INSIGHT_EVENT_CATEGORIES }) : db.eventsRecent(500, INSIGHT_EVENT_CATEGORIES).filter((e) => !opts.since || e.ts >= opts.since),
+    now: opts.now ?? Date.now(),
+    budgets: usage.budgets,
+    overrides: usage.pricing
+  };
+}
+
+// src/usage/brief.ts
+var DAY_MS = 864e5;
+function todaysCalls(db, now) {
+  const today = dayKey(now);
+  return db.apiCalls({ since: now - 1.5 * DAY_MS }).filter((c) => dayKey(c.ts) === today);
+}
+function usageBrief(db, ctx, opts = {}) {
+  const now = opts.now ?? Date.now();
+  const today = totals(todaysCalls(db, now));
+  const session = totals(opts.sessionId ? db.apiCalls({ sessionId: opts.sessionId }) : []);
+  const cacheHitRate = today.calls ? today.cacheHitRate : session.cacheHitRate;
+  const out = {
+    line: "",
+    sessionUsd: session.costUsd,
+    todayUsd: today.costUsd,
+    cacheHitRate
+  };
+  if (today.calls === 0 && session.calls === 0) return out;
+  const parts = [
+    `today ${formatUsd(today.costUsd)} (${today.calls} call${today.calls === 1 ? "" : "s"}, ${Math.round(cacheHitRate * 100)}% cache hits)`
+  ];
+  if (session.calls > 0) parts.push(`session ${formatUsd(session.costUsd)}`);
+  try {
+    const scope = session.calls > 0 ? { sessionId: opts.sessionId } : { since: now - 1.5 * DAY_MS };
+    const { insights } = detectInsights(loadInsightInput(db, ctx, { ...scope, now }));
+    const top2 = insights[0];
+    if (top2) {
+      out.topInsight = top2;
+      const saving = top2.estimatedSavingsUsd && top2.estimatedSavingsUsd >= 5e-3 ? ` (~${formatUsd(top2.estimatedSavingsUsd)})` : "";
+      parts.push(`top insight: ${top2.title.charAt(0).toLowerCase()}${top2.title.slice(1)}${saving}`);
+    }
+  } catch {
+  }
+  out.line = `usage: ${parts.join(" \xB7 ")}`;
+  return out;
+}
+
+// src/usage/ingest.ts
+init_esm_shims();
+import { createHash as createHash3 } from "crypto";
+import { closeSync, existsSync as existsSync18, openSync, readdirSync as readdirSync6, readSync, statSync as statSync11 } from "fs";
+import { homedir as homedir4 } from "os";
+import { basename as basename2, dirname as dirname11, join as join24, resolve as resolve8, sep as sep3 } from "path";
+
+// src/usage/transcript.ts
+init_esm_shims();
+var NON_TEXT_PART_CHARS = 6400;
+var DENIAL_RE = /^\s*PreToolUse:|hook error|\bdenied\b/i;
+function isObj2(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function str2(v) {
+  return typeof v === "string" && v.length ? v : null;
+}
+function num4(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : 0;
+}
+function numOrNull(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : null;
+}
+function tsOf(e) {
+  const t = e.timestamp;
+  if (typeof t === "string") {
+    const ms = Date.parse(t);
+    if (Number.isFinite(ms) && ms > 0) return ms;
+    return void 0;
+  }
+  if (typeof t === "number" && Number.isFinite(t) && t > 0) return t < 1e12 ? t * 1e3 : t;
+  return void 0;
+}
+function resultChars(content) {
+  if (typeof content === "string") return content.length;
+  if (Array.isArray(content)) {
+    let n = 0;
+    for (const part of content) {
+      if (!isObj2(part)) {
+        n += safeJsonLength(part);
+        continue;
+      }
+      const kind = str2(part.type);
+      if (kind === "text" || typeof part.text === "string") n += str2(part.text)?.length ?? 0;
+      else if (kind === "image" || kind === "document" || kind === "tool_reference")
+        n += NON_TEXT_PART_CHARS;
+      else n += safeJsonLength(part);
+    }
+    return n;
+  }
+  if (content === void 0 || content === null) return 0;
+  return safeJsonLength(content);
+}
+function resultText(content) {
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) {
+    const parts = [];
+    for (const part of content)
+      if (isObj2(part) && typeof part.text === "string") parts.push(part.text);
+    return parts.join("\n");
+  }
+  return "";
+}
+function safeJsonLength(v) {
+  try {
+    return JSON.stringify(v)?.length ?? 0;
+  } catch {
+    return 0;
+  }
+}
+function parseTranscriptLines(lines, ctx) {
+  const calls = /* @__PURE__ */ new Map();
+  const toolUses = /* @__PURE__ */ new Map();
+  const contextEvents = [];
+  let lastTs;
+  let prevTs;
+  const fallbackTs = typeof ctx.fallbackTs === "number" && Number.isFinite(ctx.fallbackTs) && ctx.fallbackTs > 0 ? ctx.fallbackTs : Date.now();
+  let denied = 0;
+  for (const raw of lines) {
+    const line = raw.trim();
+    if (!line) continue;
+    let e;
+    try {
+      e = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (!isObj2(e)) continue;
+    const type = str2(e.type);
+    if (!type) continue;
+    const sessionId = str2(e.sessionId) ?? ctx.sessionId;
+    const agentId = str2(e.agentId);
+    const sidechain = e.isSidechain === true ? 1 : 0;
+    const real = tsOf(e);
+    const ts = real ?? prevTs ?? fallbackTs;
+    prevTs = ts;
+    if (real !== void 0) lastTs = lastTs === void 0 ? real : Math.max(lastTs, real);
+    if (type === "assistant") {
+      const msg = isObj2(e.message) ? e.message : void 0;
+      if (!msg) continue;
+      const messageId = str2(msg.id);
+      const requestId = str2(e.requestId) ?? messageId;
+      if (Array.isArray(msg.content)) {
+        for (const block of msg.content) {
+          if (!isObj2(block) || block.type !== "tool_use") continue;
+          const id = str2(block.id);
+          if (!id) continue;
+          const prev2 = toolUses.get(id);
+          toolUses.set(id, {
+            tool_use_id: id,
+            session_id: prev2?.session_id ?? sessionId,
+            agent_id: prev2?.agent_id ?? agentId,
+            ts: prev2?.ts ?? ts,
+            tool: str2(block.name) ?? prev2?.tool ?? "",
+            input_chars: block.input === void 0 ? 0 : safeJsonLength(block.input),
+            result_chars: prev2?.result_chars ?? null,
+            is_error: prev2?.is_error ?? 0,
+            request_id: requestId ?? prev2?.request_id ?? null
+          });
+        }
+      }
+      const usage = isObj2(msg.usage) ? msg.usage : void 0;
+      if (!usage || !messageId || !requestId) continue;
+      const model = str2(msg.model) ?? "unknown";
+      const cc = isObj2(usage.cache_creation) ? usage.cache_creation : void 0;
+      const create5m = cc ? num4(cc.ephemeral_5m_input_tokens) : num4(usage.cache_creation_input_tokens);
+      const create1h = cc ? num4(cc.ephemeral_1h_input_tokens) : 0;
+      const details = isObj2(usage.output_tokens_details) ? usage.output_tokens_details : void 0;
+      const server2 = isObj2(usage.server_tool_use) ? usage.server_tool_use : void 0;
+      const key = `${requestId}\0${messageId}`;
+      const prev = calls.get(key);
+      calls.set(key, {
+        request_id: requestId,
+        message_id: messageId,
+        session_id: prev?.session_id ?? sessionId,
+        agent_id: agentId ?? prev?.agent_id ?? null,
+        sidechain: prev?.sidechain || sidechain,
+        ts: prev?.ts ?? ts,
+        model,
+        input_tokens: num4(usage.input_tokens),
+        output_tokens: num4(usage.output_tokens),
+        cache_create_5m: create5m,
+        cache_create_1h: create1h,
+        cache_read: num4(usage.cache_read_input_tokens),
+        thinking_tokens: details ? num4(details.thinking_tokens) : 0,
+        web_searches: server2 ? num4(server2.web_search_requests) : 0,
+        web_fetches: server2 ? num4(server2.web_fetch_requests) : 0,
+        service_tier: str2(usage.service_tier),
+        speed: str2(usage.speed),
+        stop_reason: str2(msg.stop_reason) ?? prev?.stop_reason ?? null,
+        prompt_id: str2(e.promptId) ?? prev?.prompt_id ?? null,
+        git_branch: str2(e.gitBranch) ?? prev?.git_branch ?? null,
+        cwd: str2(e.cwd) ?? prev?.cwd ?? null,
+        effort: str2(e.effort) ?? prev?.effort ?? null,
+        version: str2(e.version) ?? prev?.version ?? null,
+        entrypoint: str2(e.entrypoint) ?? prev?.entrypoint ?? null
+      });
+      continue;
+    }
+    if (type === "user") {
+      const msg = isObj2(e.message) ? e.message : void 0;
+      if (!msg || !Array.isArray(msg.content)) continue;
+      for (const block of msg.content) {
+        if (!isObj2(block) || block.type !== "tool_result") continue;
+        const id = str2(block.tool_use_id);
+        if (!id) continue;
+        const prev = toolUses.get(id);
+        let isError = prev?.is_error ?? 0;
+        if (block.is_error === true) {
+          if (DENIAL_RE.test(resultText(block.content))) denied += 1;
+          else isError = 1;
+        }
+        toolUses.set(id, {
+          tool_use_id: id,
+          session_id: prev?.session_id ?? sessionId,
+          agent_id: prev?.agent_id ?? agentId,
+          ts: prev?.ts ?? ts,
+          tool: prev?.tool ?? "",
+          input_chars: prev?.input_chars ?? 0,
+          result_chars: resultChars(block.content),
+          is_error: isError,
+          request_id: prev?.request_id ?? null
+        });
+      }
+      continue;
+    }
+    if (type === "system") {
+      const subtype = str2(e.subtype);
+      if (subtype === "compact_boundary") {
+        const meta4 = isObj2(e.compactMetadata) ? e.compactMetadata : void 0;
+        contextEvents.push({
+          session_id: sessionId,
+          ts,
+          kind: "compact",
+          trigger: meta4 ? str2(meta4.trigger) : null,
+          pre_tokens: meta4 ? numOrNull(meta4.preTokens) : null,
+          post_tokens: meta4 ? numOrNull(meta4.postTokens) : null
+        });
+      } else if (subtype === "local_command") {
+        const run = isObj2(e.commandRun) ? e.commandRun : void 0;
+        if (run && str2(run.command) === "clear") {
+          contextEvents.push({
+            session_id: sessionId,
+            ts,
+            kind: "clear",
+            trigger: "manual",
+            pre_tokens: null,
+            post_tokens: null
+          });
+        }
+      }
+    }
+  }
+  const out = {
+    calls: [...calls.values()],
+    toolUses: [...toolUses.values()],
+    contextEvents,
+    denied
+  };
+  if (lastTs !== void 0) out.lastTs = lastTs;
+  return out;
+}
+
+// src/usage/ingest.ts
+var ZERO = { calls: 0, toolUses: 0, contextEvents: 0 };
+var HEAD_BYTES = 512;
+var SNAPSHOT_MAX_AGE_MS = 30 * 24 * 60 * 6e4;
+var SNAPSHOT_KEEP_PER_SESSION = 500;
+var SESSION_ID_RE = /^[A-Za-z0-9_-]{1,80}$/;
+function isValidSessionId(id) {
+  return SESSION_ID_RE.test(id);
+}
+function claudeDir2() {
+  return process.env.EMINIAR_CLAUDE_DIR || join24(homedir4(), ".claude");
+}
+function insideDir(path3, dir) {
+  const d = resolve8(dir);
+  const p = resolve8(path3);
+  return p === d || p.startsWith(d.endsWith(sep3) ? d : d + sep3);
+}
+function isTranscriptFile(path3) {
+  if (!path3.endsWith(".jsonl")) return false;
+  try {
+    return statSync11(path3).isFile();
+  } catch {
+    return false;
+  }
+}
+function transcriptSlug(root) {
+  return root.replace(/[^A-Za-z0-9]/g, "-");
+}
+function transcriptDirFor(root) {
+  return join24(claudeDir2(), "projects", transcriptSlug(root));
+}
+function usageEnabled(ctx) {
+  return ctx.config.usage.enabled !== false;
+}
+function priceCalls(calls, overrides) {
+  return calls.map((c) => {
+    const price2 = resolvePrice(c.model, overrides);
+    if (!price2) return { ...c, cost_usd: null, priced: 0 };
+    return { ...c, cost_usd: costOfCall(c, price2).total, priced: 1 };
+  });
+}
+function readCompleteLines(path3, offset, size) {
+  const length = size - offset;
+  if (length <= 0) return { lines: [], nextOffset: offset };
+  const buf = Buffer.alloc(length);
+  const fd = openSync(path3, "r");
+  let read2 = 0;
+  try {
+    while (read2 < length) {
+      const n = readSync(fd, buf, read2, length - read2, offset + read2);
+      if (n <= 0) break;
+      read2 += n;
+    }
+  } finally {
+    closeSync(fd);
+  }
+  const end = buf.lastIndexOf(10, read2 - 1);
+  if (end < 0) return { lines: [], nextOffset: offset };
+  const text2 = buf.toString("utf8", 0, end + 1);
+  return { lines: text2.split("\n"), nextOffset: offset + end + 1 };
+}
+function headHash(path3, length) {
+  if (length <= 0) return null;
+  const buf = Buffer.alloc(length);
+  let read2 = 0;
+  const fd = openSync(path3, "r");
+  try {
+    while (read2 < length) {
+      const n = readSync(fd, buf, read2, length - read2, read2);
+      if (n <= 0) break;
+      read2 += n;
+    }
+  } finally {
+    closeSync(fd);
+  }
+  return createHash3("sha1").update(buf.subarray(0, read2)).digest("hex");
+}
+function byteAt(path3, pos) {
+  if (pos < 0) return void 0;
+  const buf = Buffer.alloc(1);
+  const fd = openSync(path3, "r");
+  try {
+    return readSync(fd, buf, 0, 1, pos) === 1 ? buf[0] : void 0;
+  } finally {
+    closeSync(fd);
+  }
+}
+function sessionIdFromName(path3) {
+  const dir = dirname11(path3);
+  if (basename2(dir) === "subagents") return basename2(dirname11(dir));
+  const name = basename2(path3, ".jsonl");
+  return name.startsWith("agent-") ? void 0 : name;
+}
+function contextEventExists(db, e) {
+  return db.contextEvents({ sessionId: e.session_id, since: e.ts, until: e.ts + 1 }).some((x) => x.kind === e.kind);
+}
+function resumeOffset(path3, prev, size, mtime) {
+  if (!prev || prev.offset <= 0) return 0;
+  if (size < prev.offset) return 0;
+  if (prev.head_hash) {
+    const want = Math.min(HEAD_BYTES, prev.size);
+    try {
+      if (headHash(path3, want) !== prev.head_hash) return 0;
+    } catch {
+      return 0;
+    }
+  }
+  if (prev.mtime !== mtime) {
+    try {
+      if (byteAt(path3, prev.offset - 1) !== 10) return 0;
+    } catch {
+      return 0;
+    }
+  }
+  return prev.offset;
+}
+function ingestTranscript(db, path3, opts = {}) {
+  if (!path3.endsWith(".jsonl")) return ZERO;
+  let size;
+  let mtime;
+  try {
+    const st = statSync11(path3);
+    if (!st.isFile()) return ZERO;
+    size = st.size;
+    mtime = Math.floor(st.mtimeMs);
+  } catch {
+    return ZERO;
+  }
+  const prev = db.transcriptFileGet(path3);
+  const offset = resumeOffset(path3, prev, size, mtime);
+  const sessionHint = opts.sessionId ?? prev?.session_id ?? sessionIdFromName(path3);
+  if (offset === size) {
+    if (!prev || prev.size !== size || prev.mtime !== mtime || sessionHint && !prev.session_id)
+      db.transcriptFileSet({
+        path: path3,
+        session_id: sessionHint ?? null,
+        offset,
+        size,
+        mtime,
+        head_hash: prev?.size === size ? prev.head_hash ?? null : fingerprint(path3, size),
+        ingested_at: Date.now()
+      });
+    return ZERO;
+  }
+  const { lines, nextOffset } = readCompleteLines(path3, offset, size);
+  const parsed = parseTranscriptLines(lines, {
+    sessionId: sessionHint ?? "unknown",
+    path: path3,
+    fallbackTs: mtime
+  });
+  const calls = priceCalls(parsed.calls, opts.overrides);
+  const counts = { calls: 0, toolUses: 0, contextEvents: 0 };
+  const sessionSeen = parsed.calls[0]?.session_id ?? parsed.toolUses[0]?.session_id;
+  const head = fingerprint(path3, size);
+  db.transaction(() => {
+    counts.calls = db.apiCallsUpsert(calls);
+    counts.toolUses = db.toolUsesUpsert(parsed.toolUses);
+    for (const e of parsed.contextEvents) {
+      if (contextEventExists(db, e)) continue;
+      db.contextEventInsert(e);
+      counts.contextEvents++;
+    }
+    db.transcriptFileSet({
+      path: path3,
+      session_id: sessionHint ?? sessionSeen ?? null,
+      offset: nextOffset,
+      size,
+      mtime,
+      head_hash: head,
+      ingested_at: Date.now()
+    });
+  });
+  return counts;
+}
+function fingerprint(path3, size) {
+  try {
+    return headHash(path3, Math.min(HEAD_BYTES, size));
+  } catch {
+    return null;
+  }
+}
+function pruneSnapshots(db) {
+  try {
+    db.statuslineSnapshotsPrune({
+      olderThan: Date.now() - SNAPSHOT_MAX_AGE_MS,
+      keepPerSession: SNAPSHOT_KEEP_PER_SESSION
+    });
+  } catch {
+  }
+}
+function add(a, b) {
+  return {
+    calls: a.calls + b.calls,
+    toolUses: a.toolUses + b.toolUses,
+    contextEvents: a.contextEvents + b.contextEvents
+  };
+}
+function listJsonl(dir) {
+  try {
+    return readdirSync6(dir).filter((f) => f.endsWith(".jsonl")).map((f) => join24(dir, f));
+  } catch {
+    return [];
+  }
+}
+function firstEntrySessionId(path3) {
+  try {
+    const { lines } = readCompleteLines(path3, 0, Math.min(statSync11(path3).size, 64 * 1024));
+    for (const line of lines) {
+      if (!line.trim()) continue;
+      const e = JSON.parse(line);
+      return typeof e.sessionId === "string" ? e.sessionId : void 0;
+    }
+  } catch {
+  }
+  return void 0;
+}
+function sidechainFilesFor(db, dir, sessionId) {
+  if (!isValidSessionId(sessionId)) return [];
+  const inside = (p) => insideDir(p, dir) && p.endsWith(".jsonl");
+  const out = listJsonl(join24(dir, sessionId, "subagents")).filter(inside);
+  for (const path3 of listJsonl(dir)) {
+    if (!inside(path3) || !basename2(path3).startsWith("agent-")) continue;
+    const known = db.transcriptFileGet(path3)?.session_id;
+    let owner = known ?? void 0;
+    if (!owner) {
+      owner = firstEntrySessionId(path3);
+      if (owner) {
+        db.transcriptFileSet({
+          path: path3,
+          session_id: owner,
+          offset: 0,
+          size: 0,
+          mtime: 0,
+          ingested_at: Date.now()
+        });
+      }
+    }
+    if (owner === sessionId) out.push(path3);
+  }
+  return out;
+}
+function ingestSession(db, root, sessionId, transcriptPath, opts = {}) {
+  if (!isValidSessionId(sessionId)) return ZERO;
+  let main;
+  const trusted = transcriptPath ?? db.sessionGet(sessionId)?.transcript_path ?? void 0;
+  if (trusted) {
+    if (!isTranscriptFile(trusted)) return ZERO;
+    main = resolve8(trusted);
+  } else {
+    const built = resolve8(transcriptDirFor(root), `${sessionId}.jsonl`);
+    if (!insideDir(built, claudeDir2())) return ZERO;
+    main = built;
+  }
+  let total = ingestTranscript(db, main, { sessionId, overrides: opts.overrides });
+  for (const path3 of sidechainFilesFor(db, dirname11(main), sessionId)) {
+    total = add(total, ingestTranscript(db, path3, { sessionId, overrides: opts.overrides }));
+  }
+  pruneSnapshots(db);
+  return total;
+}
+function ingestProject(db, root, opts = {}) {
+  const dir = transcriptDirFor(root);
+  const files = new Set(listJsonl(dir));
+  if (existsSync18(dir)) {
+    try {
+      for (const entry of readdirSync6(dir, { withFileTypes: true })) {
+        if (entry.isDirectory())
+          for (const sub of listJsonl(join24(dir, entry.name, "subagents"))) files.add(sub);
+      }
+    } catch {
+    }
+  }
+  for (const s of db.sessionsRecent(1e3)) if (s.transcript_path) files.add(s.transcript_path);
+  let total = ZERO;
+  let touched = 0;
+  for (const path3 of files) {
+    let st;
+    try {
+      const s = statSync11(path3);
+      if (!s.isFile()) continue;
+      st = { size: s.size, mtime: Math.floor(s.mtimeMs) };
+    } catch {
+      continue;
+    }
+    const prev = db.transcriptFileGet(path3);
+    if (prev && prev.size === st.size && prev.mtime === st.mtime && prev.offset === st.size)
+      continue;
+    touched++;
+    const sessionId = prev?.session_id ?? sessionIdFromName(path3);
+    total = add(total, ingestTranscript(db, path3, { sessionId, overrides: opts.overrides }));
+  }
+  pruneSnapshots(db);
+  return { ...total, files: touched };
+}
+
 // src/tools/em_stats.ts
 var emStats = defineTool({
   name: "em_stats",
@@ -58704,9 +61051,28 @@ var emStats = defineTool({
     parts.push(
       `index: ${db.countDocuments()} documents (${db.countDocuments("exec")} exec, ${db.countDocuments("batch")} batch, ${db.countDocuments("file")} file, ${db.countDocuments("url")} url, ${db.countDocuments("code")} code), ${db.vecCount()} vectors`
     );
+    const cost = usageLine(ctx, sessionId);
+    if (cost) parts.push(cost);
     return text(parts.join("\n\n"));
   }
 });
+function usageLine(ctx, sessionId) {
+  if (!usageEnabled(ctx)) return void 0;
+  try {
+    const db = getStorage(ctx);
+    let failed;
+    try {
+      ingestSession(db, ctx.root, sessionId, void 0, { overrides: ctx.config.usage.pricing });
+    } catch (err) {
+      failed = `usage: ingest failed: ${err.message}`;
+    }
+    const b = usageBrief(db, ctx, { sessionId });
+    const line = b.todayUsd || b.sessionUsd ? `usage: today ${formatUsd(b.todayUsd)} \xB7 session ${formatUsd(b.sessionUsd)} \xB7 see em_usage` : void 0;
+    return [line, failed].filter((s) => s).join("\n") || void 0;
+  } catch (err) {
+    return `usage: unavailable: ${err.message}`;
+  }
+}
 function mergeByTool(rows) {
   const m = /* @__PURE__ */ new Map();
   for (const r of rows) {
@@ -58860,6 +61226,536 @@ function groupBySource(edges) {
   return out;
 }
 
+// src/tools/em_usage.ts
+init_esm_shims();
+var USAGE_VIEWS = [
+  "summary",
+  "daily",
+  "weekly",
+  "monthly",
+  "models",
+  "sessions",
+  "blocks",
+  "turns",
+  "tools",
+  "insights",
+  "savings"
+];
+var DAY4 = 864e5;
+var UNITS = { s: 1e3, m: 6e4, h: 36e5, d: DAY4, w: 7 * DAY4 };
+var SINCE_MIN = Date.UTC(2e3, 0, 1);
+function parseSince(value, now = Date.now()) {
+  const s = value?.trim();
+  if (!s) return void 0;
+  const bad = () => new Error(
+    `invalid since "${value}": use an ISO date (2026-10-01) or a relative value like 30d, 12h, 2w`
+  );
+  let ms;
+  const rel = /^(\d{1,6})([smhdw])$/i.exec(s);
+  if (rel) ms = now - Number(rel[1]) * (UNITS[rel[2].toLowerCase()] ?? DAY4);
+  else if (/^\d{4}-\d{2}-\d{2}(T.*)?$/.test(s)) ms = Date.parse(s);
+  else throw bad();
+  if (!Number.isFinite(ms) || ms < SINCE_MIN || ms > now + DAY4) throw bad();
+  return ms;
+}
+var LIMIT_MAX = 1e3;
+var LIMIT_DEFAULT = 20;
+function parseLimit(value) {
+  if (value === void 0) return void 0;
+  const n = typeof value === "number" ? value : /^\d{1,6}$/.test(value.trim()) ? Number(value.trim()) : Number.NaN;
+  if (!Number.isInteger(n) || n < 1 || n > LIMIT_MAX)
+    return `limit must be a whole number between 1 and ${LIMIT_MAX}`;
+  return n;
+}
+var clampLimit = (n) => n === void 0 || !Number.isFinite(n) ? LIMIT_DEFAULT : Math.min(LIMIT_MAX, Math.max(1, Math.floor(n)));
+var INGEST_GUARD_MS = 1e4;
+var lastIngest = /* @__PURE__ */ new Map();
+var sessionIngestKey = (root, sessionId) => `${root}\0${sessionId}`;
+function recentlyIngested(root, sessionId, now = Date.now()) {
+  const within = (key) => {
+    const t = lastIngest.get(key);
+    return t !== void 0 && now - t < INGEST_GUARD_MS;
+  };
+  return within(root) || sessionId !== void 0 && within(sessionIngestKey(root, sessionId));
+}
+function ingestFor(db, ctx, scope, sessionId, now) {
+  const overrides = ctx.config.usage.pricing;
+  const project = scope === "project";
+  if (recentlyIngested(ctx.root, project ? void 0 : sessionId, now)) return;
+  try {
+    if (project) ingestProject(db, ctx.root, { overrides });
+    else ingestSession(db, ctx.root, sessionId, void 0, { overrides });
+  } catch {
+  } finally {
+    lastIngest.set(project ? ctx.root : sessionIngestKey(ctx.root, sessionId), now);
+  }
+}
+function loadUsage(ctx, opts = {}) {
+  const db = getStorage(ctx);
+  const scope = opts.scope ?? "project";
+  const sessionId = opts.sessionId ?? getCurrentSession(ctx);
+  const now = opts.now ?? Date.now();
+  if (opts.ingest !== false) ingestFor(db, ctx, scope, sessionId, now);
+  const filter = scope === "session" ? { sessionId, since: opts.since } : { since: opts.since, sessionId: void 0 };
+  return {
+    scope,
+    sessionId,
+    since: opts.since,
+    now,
+    calls: db.apiCalls(filter).filter(isRealCall),
+    toolUses: db.toolUses(filter),
+    contextEvents: db.contextEvents(scope === "session" ? { sessionId } : {}),
+    stats: scope === "session" ? db.statsBySession(sessionId) : db.statsAll(),
+    snapshot: db.statuslineLatest(scope === "session" ? sessionId : void 0)
+  };
+}
+function modelSlices(rows) {
+  return byModel(rows).map((g) => ({
+    model: g.key,
+    calls: g.totals.calls,
+    costUsd: g.totals.costUsd,
+    unpricedCalls: g.totals.unpricedCalls
+  })).sort((a, b) => b.costUsd - a.costUsd || b.calls - a.calls);
+}
+function periods(calls, keyFn) {
+  const buckets = /* @__PURE__ */ new Map();
+  for (const c of calls) {
+    const k = keyFn(c.ts);
+    const list2 = buckets.get(k);
+    if (list2) list2.push(c);
+    else buckets.set(k, [c]);
+  }
+  return [...buckets.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([key, rows]) => ({ key, totals: totals(rows), models: modelSlices(rows) }));
+}
+function modelRows(calls) {
+  const all = totals(calls);
+  return byModel(calls).map((g) => ({
+    model: g.key,
+    calls: g.totals.calls,
+    costUsd: g.totals.costUsd,
+    unpricedCalls: g.totals.unpricedCalls,
+    input: g.totals.input,
+    output: g.totals.output,
+    cacheRead: g.totals.cacheRead,
+    cacheWrite: g.totals.cacheCreate5m + g.totals.cacheCreate1h,
+    thinking: g.totals.thinking,
+    share: all.costUsd > 0 ? g.totals.costUsd / all.costUsd : 0
+  })).sort((a, b) => b.costUsd - a.costUsd || b.calls - a.calls);
+}
+function insightsFor(ctx, data) {
+  const db = getStorage(ctx);
+  const input2 = loadInsightInput(db, ctx, {
+    ...data.scope === "session" ? { sessionId: data.sessionId } : {},
+    ...data.since !== void 0 ? { since: data.since } : {},
+    now: data.now
+  });
+  const r = detectInsights(input2);
+  return { insights: r.insights, scores: r.scores };
+}
+var SEVERITY_RANK2 = { high: 0, warn: 1, info: 2 };
+function sortInsights(list2) {
+  return list2.slice().sort(
+    (a, b) => SEVERITY_RANK2[a.severity] - SEVERITY_RANK2[b.severity] || (b.estimatedSavingsUsd ?? 0) - (a.estimatedSavingsUsd ?? 0)
+  );
+}
+function summaryPayload(ctx, data) {
+  const { calls, now } = data;
+  const today = dayKey(now);
+  const blocks = billingBlocks(calls, now);
+  const ins = insightsFor(ctx, data);
+  return {
+    scope: data.scope,
+    sessionId: data.sessionId,
+    since: data.since,
+    now,
+    totals: totals(calls),
+    today: totals(calls.filter((c) => dayKey(c.ts) === today)),
+    last7d: totals(calls.filter((c) => c.ts >= now - 7 * DAY4)),
+    last30d: totals(calls.filter((c) => c.ts >= now - 30 * DAY4)),
+    cache: cacheStats(calls),
+    models: modelRows(calls),
+    burn: burnRate(calls, now),
+    block: activeBlock(blocks, now) ?? null,
+    insights: sortInsights(ins.insights).slice(0, 3),
+    scores: ins.scores,
+    savings: savingsFor(ctx, data),
+    snapshot: data.snapshot ?? null
+  };
+}
+function savingsFor(ctx, data) {
+  return pricedSavings(data.stats, data.calls, ctx.config.usage.pricing, { since: data.since });
+}
+function sessionsPayload(ctx, data, limit) {
+  const db = getStorage(ctx);
+  const span = /* @__PURE__ */ new Map();
+  for (const c of data.calls) {
+    const s = span.get(c.session_id);
+    if (!s) span.set(c.session_id, { first: c.ts, last: c.ts, branch: c.git_branch });
+    else {
+      s.first = Math.min(s.first, c.ts);
+      if (c.ts >= s.last) {
+        s.last = c.ts;
+        s.branch = c.git_branch ?? s.branch;
+      }
+    }
+  }
+  const rows = bySession(data.calls).map((g) => {
+    const s = span.get(g.key);
+    const row = db.sessionGet(g.key);
+    return {
+      session: g.key,
+      startedAt: row?.started_at ?? null,
+      firstCall: s?.first ?? 0,
+      lastCall: s?.last ?? 0,
+      branch: s?.branch ?? null,
+      lastPrompt: row?.last_prompt ?? null,
+      totals: g.totals
+    };
+  }).sort((a, b) => b.lastCall - a.lastCall);
+  return { rows: rows.slice(0, limit) };
+}
+function turnsPayload(ctx, data, limit) {
+  const db = getStorage(ctx);
+  const sessionId = data.sessionId;
+  const calls = data.scope === "session" ? data.calls : data.calls.filter((c) => c.session_id === sessionId);
+  const events = data.scope === "session" ? data.contextEvents : db.contextEvents({ sessionId });
+  const timeline = contextTimeline(calls, events);
+  return {
+    sessionId,
+    timeline: timeline.length > limit ? timeline.slice(-limit) : timeline,
+    compactions: events.length,
+    totals: totals(calls)
+  };
+}
+function usageView(ctx, view, data, limitArg = LIMIT_DEFAULT) {
+  const { calls, now } = data;
+  const limit = clampLimit(limitArg);
+  switch (view) {
+    case "summary":
+      return summaryPayload(ctx, data);
+    case "daily":
+      return { rows: periods(calls, (ts) => dayKey(ts)), totals: totals(calls) };
+    case "weekly":
+      return { rows: periods(calls, (ts) => weekKey(ts)), totals: totals(calls) };
+    case "monthly":
+      return { rows: periods(calls, (ts) => monthKey(ts)), totals: totals(calls) };
+    case "models":
+      return {
+        rows: modelRows(calls),
+        byEffort: byEffort(calls),
+        bySpeed: bySpeed(calls),
+        agents: byAgent(calls)
+      };
+    case "sessions":
+      return sessionsPayload(ctx, data, limit);
+    case "blocks": {
+      const blocks = billingBlocks(calls, now).reverse();
+      return { rows: blocks.slice(0, limit), burn: burnRate(calls, now) };
+    }
+    case "turns":
+      return turnsPayload(ctx, data, limit);
+    case "tools": {
+      const rows = topToolConsumers(data.toolUses, limit);
+      return {
+        rows,
+        totalChars: data.toolUses.reduce((n, u) => n + (u.result_chars ?? 0), 0)
+      };
+    }
+    case "insights": {
+      const r = insightsFor(ctx, data);
+      return { insights: sortInsights(r.insights), scores: r.scores };
+    }
+    case "savings":
+      return savingsFor(ctx, data);
+  }
+}
+function textTable(headers, rows, aligns) {
+  const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length)));
+  const line = (cells) => `  ${cells.map((c, i) => {
+    const w = widths[i] ?? c.length;
+    return (aligns?.[i] ?? (i === 0 ? "l" : "r")) === "l" ? c.padEnd(w) : c.padStart(w);
+  }).join("  ").trimEnd()}`;
+  return [line(headers), ...rows.map(line)].join("\n");
+}
+var usd2 = (n) => formatUsd(n);
+var pct2 = (x) => `${Math.round(x * 100)}%`;
+var shortId = (id) => id.slice(0, 8);
+var hhmm = (ts) => new Date(ts).toISOString().slice(11, 19);
+var dateTime = (ts) => new Date(ts).toISOString().slice(0, 16).replace("T", " ");
+var shortModel = (m) => m.replace(/^claude-/, "").replace(/-\d{8}(\[1m\])?$/, "$1");
+function fmtGap(ms) {
+  if (!(ms >= 36e5)) return "<1h";
+  const h = Math.floor(ms / 36e5);
+  const m = Math.floor(ms % 36e5 / 6e4);
+  return `${h}:${String(m).padStart(2, "0")}`;
+}
+var burnLine = (b) => b.reliable ? `${usd2(b.usdPerHour)}/h \xB7 ${fmtTokens(Math.round(b.tokensPerMin))} tok/min \xB7 projected ${usd2(b.projectedBlockUsd ?? 0)}` : `burn n/a (needs ${BURN_MIN_CALLS}+ calls over ${BURN_MIN_MINUTES}+ min)`;
+var EST_NOTE = "est. at list price";
+function totalsLine(t) {
+  const unpriced = t.unpricedCalls ? ` \xB7 ${t.unpricedCalls} unpriced` : "";
+  return `${t.calls} calls \xB7 ${usd2(t.costUsd)}${unpriced} \xB7 in ${fmtTokens(t.input)} \xB7 out ${fmtTokens(t.output)} \xB7 cache read ${fmtTokens(t.cacheRead)} \xB7 cache write ${fmtTokens(t.cacheCreate5m + t.cacheCreate1h)} \xB7 ${pct2(t.cacheHitRate)} cache hits`;
+}
+function scopeTitle(p) {
+  const s = p.scope === "session" ? `session ${shortId(p.sessionId)}` : "project";
+  return p.since ? `${s} since ${dateTime(p.since)} UTC` : s;
+}
+function renderSummary(p) {
+  const out = [`usage (${scopeTitle(p)}, ${EST_NOTE}): ${totalsLine(p.totals)}`];
+  out.push(
+    `  cost: today ${usd2(p.today.costUsd)} (${p.today.calls} calls) \xB7 7d ${usd2(p.last7d.costUsd)} \xB7 30d ${usd2(p.last30d.costUsd)}`
+  );
+  out.push(
+    `  cache: ${pct2(p.cache.hitRate)} hit rate \xB7 ${fmtTokens(p.cache.cacheReads)} read \xB7 ${fmtTokens(p.cache.cacheWrites)} written \xB7 ${p.cache.coldCalls} cold call(s)${p.cache.share1h > 0 ? ` \xB7 ${pct2(p.cache.share1h)} 1h writes` : ""}`
+  );
+  if (p.models.length)
+    out.push(
+      `  models: ${p.models.map(
+        (m) => `${shortModel(m.model)} ${m.calls} calls ${usd2(m.costUsd)}${m.unpricedCalls ? ` (${m.unpricedCalls} unpriced)` : ""}`
+      ).join(" \xB7 ")}`
+    );
+  if (p.block)
+    out.push(
+      `  active block: started ${hhmm(p.block.start)} UTC \xB7 ${p.block.calls} calls \xB7 ${usd2(p.block.costUsd)} \xB7 ${burnLine(p.burn)}`
+    );
+  else out.push("  active block: none (no calls in the current 5-hour window)");
+  if (p.snapshot && (p.snapshot.five_hour_pct != null || p.snapshot.seven_day_pct != null)) {
+    const plan = [
+      p.snapshot.five_hour_pct != null ? `5h ${p.snapshot.five_hour_pct}%` : "",
+      p.snapshot.seven_day_pct != null ? `7d ${p.snapshot.seven_day_pct}%` : "",
+      p.snapshot.ctx_used_pct != null ? `ctx ${p.snapshot.ctx_used_pct}%` : ""
+    ].filter(Boolean);
+    out.push(`  plan: ${plan.join(" \xB7 ")}`);
+  }
+  if (p.insights.length) {
+    out.push("  insights:");
+    for (const i of p.insights) out.push(`    [${i.severity}] ${i.title}: ${i.reason}`);
+  } else out.push("  insights: none");
+  out.push(
+    `  eminiar savings: ${fmtTokens(p.savings.savedTokens)} tokens kept out of context \u2248 ${usd2(p.savings.directUsd)} direct + ${usd2(p.savings.compoundingUsd)} compounding (see em_usage view:"savings")`
+  );
+  if (p.totals.unpricedCalls)
+    out.push(
+      `  note: ${p.totals.unpricedCalls} call(s) use a model without a bundled price; add config.usage.pricing to price them`
+    );
+  return out.join("\n");
+}
+function renderPeriods(label, p) {
+  if (!p.rows.length) return `${label}: no API calls recorded`;
+  const rows = p.rows.map((r) => [
+    r.key,
+    String(r.totals.calls),
+    usd2(r.totals.costUsd),
+    fmtTokens(r.totals.input),
+    fmtTokens(r.totals.output),
+    fmtTokens(r.totals.cacheRead),
+    fmtTokens(r.totals.cacheCreate5m + r.totals.cacheCreate1h),
+    pct2(r.totals.cacheHitRate),
+    r.models.map((m) => `${shortModel(m.model)} ${usd2(m.costUsd)}`).join(", ") + (r.totals.unpricedCalls ? ` (${r.totals.unpricedCalls} unpriced)` : "")
+  ]);
+  return `${label}: ${totalsLine(p.totals)}
+${textTable(
+    ["period", "calls", "cost", "in", "out", "cache rd", "cache wr", "hits", "models"],
+    rows,
+    ["l", "r", "r", "r", "r", "r", "r", "r", "l"]
+  )}
+  periods are local calendar days; cost ${EST_NOTE}`;
+}
+function renderModels(p) {
+  if (!p.rows.length) return "models: no API calls recorded";
+  const out = [
+    "models:",
+    textTable(
+      ["model", "calls", "cost", "share", "in", "out", "cache rd", "cache wr", "thinking"],
+      p.rows.map((m) => [
+        shortModel(m.model) + (m.unpricedCalls ? " (unpriced)" : ""),
+        String(m.calls),
+        usd2(m.costUsd),
+        pct2(m.share),
+        fmtTokens(m.input),
+        fmtTokens(m.output),
+        fmtTokens(m.cacheRead),
+        fmtTokens(m.cacheWrite),
+        fmtTokens(m.thinking)
+      ])
+    )
+  ];
+  const line = (title, groups) => `  ${title}: ${groups.map((g) => `${g.key} ${g.totals.calls} calls ${usd2(g.totals.costUsd)}`).join(" \xB7 ")}`;
+  if (p.byEffort.length > 1) out.push(line("effort", p.byEffort));
+  if (p.bySpeed.some((g) => g.key === "fast")) out.push(line("speed", p.bySpeed));
+  if (p.agents.subagents.length)
+    out.push(
+      `  subagents: ${p.agents.subagents.length} \xB7 ${usd2(p.agents.subagents.reduce((s, a) => s + a.totals.costUsd, 0))} (${pct2(p.agents.delegationShare)} of cost)`
+    );
+  out.push(`  cost ${EST_NOTE}`);
+  return out.join("\n");
+}
+function renderSessions(p) {
+  if (!p.rows.length) return "sessions: no API calls recorded";
+  return `sessions:
+${textTable(
+    ["session", "last call (UTC)", "branch", "calls", "cost", "in", "out", "hits", "prompt"],
+    p.rows.map((s) => [
+      shortId(s.session),
+      dateTime(s.lastCall),
+      s.branch ?? "",
+      String(s.totals.calls),
+      usd2(s.totals.costUsd),
+      fmtTokens(s.totals.input),
+      fmtTokens(s.totals.output),
+      pct2(s.totals.cacheHitRate),
+      (s.lastPrompt ?? "").replace(/\s+/g, " ").slice(0, 50)
+    ]),
+    ["l", "l", "l", "r", "r", "r", "r", "r", "l"]
+  )}`;
+}
+function renderBlocks(p) {
+  if (!p.rows.length) return "blocks: no API calls recorded";
+  const rows = p.rows.map((b) => [
+    `${dateTime(b.start)}${b.active ? " *" : ""}`,
+    `${hhmm(b.firstCall)}\u2013${hhmm(b.lastCall)}`,
+    String(b.calls),
+    usd2(b.costUsd),
+    fmtTokens(b.tokens.input + b.tokens.output + b.tokens.cacheCreate + b.tokens.cacheRead),
+    b.gapBefore != null ? fmtGap(b.gapBefore) : "",
+    b.models.map(shortModel).join(", ") + (b.unpricedCalls ? ` (${b.unpricedCalls} unpriced)` : "")
+  ]);
+  const out = [
+    "5-hour billing blocks (times in UTC, * = active):",
+    textTable(["block (UTC)", "calls at (UTC)", "calls", "cost", "tokens", "gap", "models"], rows, [
+      "l",
+      "l",
+      "r",
+      "r",
+      "r",
+      "r",
+      "l"
+    ])
+  ];
+  if (p.rows.some((b) => b.active))
+    out.push(
+      p.burn.reliable ? `  burn: ${usd2(p.burn.usdPerHour)}/h \xB7 ${fmtTokens(Math.round(p.burn.tokensPerMin))} tok/min over ${Math.round(p.burn.windowMinutes)} min \xB7 projected ${usd2(p.burn.projectedBlockUsd ?? 0)} for the block` : `  ${burnLine(p.burn)}`
+    );
+  return out.join("\n");
+}
+function renderTurns(p) {
+  if (!p.timeline.length) return `turns (session ${shortId(p.sessionId)}): no API calls recorded`;
+  const rows = p.timeline.map((t) => [
+    hhmm(t.ts),
+    shortModel(t.model),
+    fmtTokens(t.contextTokens),
+    fmtTokens(t.output),
+    usd2(t.costUsd),
+    t.compactBefore ? "compacted before this call" : ""
+  ]);
+  const shown = p.timeline.length;
+  const count = shown < p.totals.calls ? `last ${shown} of ${p.totals.calls} calls` : `${shown} calls`;
+  return `turns (session ${shortId(p.sessionId)}): ${count} \xB7 ${p.compactions} compaction(s) \xB7 ${usd2(p.totals.costUsd)}
+${textTable(
+    ["time (UTC)", "model", "context", "output", "cost", ""],
+    rows,
+    ["l", "l", "r", "r", "r", "l"]
+  )}`;
+}
+function renderTools(p) {
+  if (!p.rows.length) return "tools: no tool results recorded";
+  return `tool results in context (${fmtTokens(Math.ceil(p.totalChars / 4))} est. tokens total):
+${textTable(
+    ["tool", "calls", "chars", "est tokens", "avg chars", "errors"],
+    p.rows.map((r) => [
+      r.tool,
+      String(r.calls),
+      fmtTokens(r.chars),
+      fmtTokens(r.estTokens),
+      fmtTokens(r.avgChars),
+      String(r.errors)
+    ])
+  )}`;
+}
+function renderInsights(p) {
+  const out = [];
+  if (p.insights.length) {
+    out.push(`insights (${p.insights.length}):`);
+    for (const i of p.insights) {
+      out.push(`  [${i.severity}] ${i.title} (${i.id}, ${i.scope})`);
+      out.push(`    ${i.reason}`);
+      if (i.recommendation) out.push(`    \u2192 ${i.recommendation}`);
+      if (i.estimatedSavingsUsd) out.push(`    est. savings ${usd2(i.estimatedSavingsUsd)}`);
+    }
+  } else out.push("insights: nothing to flag");
+  if (p.scores.length) {
+    out.push("scores (0\u2013100, higher is better):");
+    for (const s of p.scores) {
+      out.push(`  ${s.id.padEnd(16)} ${String(Math.round(s.value)).padStart(3)}`);
+      for (const r of s.reasons) out.push(`    - ${r}`);
+    }
+  }
+  return out.join("\n");
+}
+function renderSavings(p) {
+  const out = [
+    `eminiar savings: ${fmtTokens(p.savedTokens)} tokens kept out of context`,
+    `  direct      ${usd2(p.directUsd)}  (never written to cache: cache-write price of ${shortModel(p.model)})`,
+    `  compounding ${usd2(p.compoundingUsd)}  (never re-read on later turns: cache-read price \xD7 ${p.laterCallsPerSession.toFixed(1)} later calls per session)`,
+    "  assumptions:",
+    ...p.assumptions.map((a) => `    - ${a}`)
+  ];
+  return out.join("\n");
+}
+function renderUsage(view, payload) {
+  switch (view) {
+    case "summary":
+      return renderSummary(payload);
+    case "daily":
+      return renderPeriods("daily", payload);
+    case "weekly":
+      return renderPeriods("weekly (Monday)", payload);
+    case "monthly":
+      return renderPeriods("monthly", payload);
+    case "models":
+      return renderModels(payload);
+    case "sessions":
+      return renderSessions(payload);
+    case "blocks":
+      return renderBlocks(payload);
+    case "turns":
+      return renderTurns(payload);
+    case "tools":
+      return renderTools(payload);
+    case "insights":
+      return renderInsights(payload);
+    case "savings":
+      return renderSavings(payload);
+  }
+}
+var emUsage = defineTool({
+  name: "em_usage",
+  description: "Token, cache and cost insights for Claude Code sessions, from the transcripts on this machine: cost today / 7d / 30d, cache hit rate, per-model and per-session breakdowns, 5-hour billing blocks with burn rate, the context timeline of a session with compactions, which tools put the most into context, detected insights with scores, and what eminiar's own tools saved. Cost is an estimate at list prices; everything stays local.",
+  schema: {
+    scope: external_exports.enum(["session", "project"]).optional().describe("default project"),
+    view: external_exports.enum(USAGE_VIEWS).optional().describe("default summary"),
+    since: external_exports.string().optional().describe("ISO date/time or relative: 30d, 12h, 2w (default: everything)"),
+    limit: external_exports.number().int().positive().max(LIMIT_MAX).optional().describe(`rows for list views (${LIMIT_DEFAULT})`),
+    json: external_exports.boolean().optional().describe("return the aggregate object instead of text")
+  },
+  handler: async (args, ctx) => {
+    if (!usageEnabled(ctx))
+      return text("usage insights are off (config.usage.enabled = false); nothing is ingested");
+    const view = args.view ?? "summary";
+    let since;
+    try {
+      since = parseSince(args.since);
+    } catch (err) {
+      return errorResult(err.message);
+    }
+    const limit = parseLimit(args.limit);
+    if (typeof limit === "string") return errorResult(limit);
+    const data = loadUsage(ctx, { scope: args.scope ?? "project", since });
+    const payload = usageView(ctx, view, data, limit ?? LIMIT_DEFAULT);
+    if (args.json) return text(JSON.stringify({ view, scope: data.scope, ...payload }));
+    return text(renderUsage(view, payload));
+  }
+});
+
 // src/tools/index.ts
 var tools = [
   emExecute,
@@ -58882,6 +61778,7 @@ var tools = [
   emReindex,
   emIndexStatus,
   emStats,
+  emUsage,
   emPurge,
   emDoctor
 ];