@vpxa/kb 0.1.13 → 0.1.15

package/packages/tools/dist/diff-parse.js

@@ -1,3 +1,4 @@
-function w(u){const{diff:r}=u,n=r.split(/^diff --git /m).filter(Boolean);return n.length>0&&/^a\//.test(n[0])?D(n):k(r)}function D(u){const r=[];for(const n of u){const e=n.split(`
-`),c=e[0]?.match(/a\/(.+?)\s+b\/(.+)/);if(!c)continue;const m=c[1],o=c[2];let a="modified";n.includes("new file mode")?a="added":n.includes("deleted file mode")?a="deleted":m!==o&&(a="renamed");const d=[];let p=0,g=0,s=null,h=0,i=0;for(const t of e){const l=t.match(/^@@\s+-(\d+)(?:,(\d+))?\s+\+(\d+)(?:,(\d+))?\s+@@(.*)$/);if(l){s={oldStart:Number(l[1]),oldLines:Number(l[2]??1),newStart:Number(l[3]),newLines:Number(l[4]??1),header:l[5]?.trim()??"",changes:[]},d.push(s),h=s.oldStart,i=s.newStart;continue}if(!(!s||t.startsWith("\\"))){if(t.startsWith("+")&&!t.startsWith("+++")){s.changes.push({type:"add",line:i,content:t.slice(1)}),p+=1,i+=1;continue}if(t.startsWith("-")&&!t.startsWith("---")){s.changes.push({type:"delete",line:h,content:t.slice(1)}),g+=1,h+=1;continue}t.startsWith(" ")&&(s.changes.push({type:"context",line:i,content:t.slice(1)}),h+=1,i+=1)}}r.push({path:o,oldPath:a==="renamed"?m:void 0,status:a,hunks:d,additions:p,deletions:g})}return r}function k(u){const r=[],n=u.split(`
-`);let e=0;for(;e<n.length;){const c=n[e]?.match(/^---\s+(?:a\/)?(.+)/),m=n[e+1]?.match(/^\+\+\+\s+(?:b\/)?(.+)/);if(!c||!m){e++;continue}const o=c[1].trim(),a=m[1].trim();let d="modified";o==="/dev/null"?d="added":a==="/dev/null"?d="deleted":o!==a&&(d="renamed"),e+=2;const p=[];let g=0,s=0;for(;e<n.length&&!n[e]?.startsWith("--- ");){const i=n[e]?.match(/^@@\s+-(\d+)(?:,(\d+))?\s+\+(\d+)(?:,(\d+))?\s+@@(.*)$/);if(i){const t={oldStart:Number(i[1]),oldLines:Number(i[2]??1),newStart:Number(i[3]),newLines:Number(i[4]??1),header:i[5]?.trim()??"",changes:[]};p.push(t);let l=t.oldStart,b=t.newStart;for(e++;e<n.length;){const f=n[e];if(f?.startsWith("@@")||f?.startsWith("--- ")||f?.startsWith("diff "))break;if(f?.startsWith("\\")){e++;continue}if(f?.startsWith("+"))t.changes.push({type:"add",line:b,content:f.slice(1)}),g++,b++;else if(f?.startsWith("-"))t.changes.push({type:"delete",line:l,content:f.slice(1)}),s++,l++;else if(f?.startsWith(" "))t.changes.push({type:"context",line:b,content:f.slice(1)}),l++,b++;else break;e++}}else e++}const h=d==="deleted"?o:a;r.push({path:h,oldPath:d==="renamed"?o:void 0,status:d,hunks:p,additions:g,deletions:s})}return r}export{w as diffParse};
+function e(e){let{diff:r}=e,i=r.split(/^diff --git /m).filter(Boolean);return i.length>0&&/^a\//.test(i[0])?t(i):n(r)}function t(e){let t=[];for(let n of e){let e=n.split(`
+`),r=e[0]?.match(/a\/(.+?)\s+b\/(.+)/);if(!r)continue;let i=r[1],a=r[2],o=`modified`;n.includes(`new file mode`)?o=`added`:n.includes(`deleted file mode`)?o=`deleted`:i!==a&&(o=`renamed`);let s=[],c=0,l=0,u=null,d=0,f=0;for(let t of e){let e=t.match(/^@@\s+-(\d+)(?:,(\d+))?\s+\+(\d+)(?:,(\d+))?\s+@@(.*)$/);if(e){u={oldStart:Number(e[1]),oldLines:Number(e[2]??1),newStart:Number(e[3]),newLines:Number(e[4]??1),header:e[5]?.trim()??``,changes:[]},s.push(u),d=u.oldStart,f=u.newStart;continue}if(!(!u||t.startsWith(`\\`))){if(t.startsWith(`+`)&&!t.startsWith(`+++`)){u.changes.push({type:`add`,line:f,content:t.slice(1)}),c+=1,f+=1;continue}if(t.startsWith(`-`)&&!t.startsWith(`---`)){u.changes.push({type:`delete`,line:d,content:t.slice(1)}),l+=1,d+=1;continue}t.startsWith(` `)&&(u.changes.push({type:`context`,line:f,content:t.slice(1)}),d+=1,f+=1)}}t.push({path:a,oldPath:o===`renamed`?i:void 0,status:o,hunks:s,additions:c,deletions:l})}return t}function n(e){let t=[],n=e.split(`
+`),r=0;for(;r<n.length;){let e=n[r]?.match(/^---\s+(?:a\/)?(.+)/),i=n[r+1]?.match(/^\+\+\+\s+(?:b\/)?(.+)/);if(!e||!i){r++;continue}let a=e[1].trim(),o=i[1].trim(),s=`modified`;a===`/dev/null`?s=`added`:o===`/dev/null`?s=`deleted`:a!==o&&(s=`renamed`),r+=2;let c=[],l=0,u=0;for(;r<n.length&&!n[r]?.startsWith(`--- `);){let e=n[r]?.match(/^@@\s+-(\d+)(?:,(\d+))?\s+\+(\d+)(?:,(\d+))?\s+@@(.*)$/);if(e){let t={oldStart:Number(e[1]),oldLines:Number(e[2]??1),newStart:Number(e[3]),newLines:Number(e[4]??1),header:e[5]?.trim()??``,changes:[]};c.push(t);let i=t.oldStart,a=t.newStart;for(r++;r<n.length;){let e=n[r];if(e?.startsWith(`@@`)||e?.startsWith(`--- `)||e?.startsWith(`diff `))break;if(e?.startsWith(`\\`)){r++;continue}if(e?.startsWith(`+`))t.changes.push({type:`add`,line:a,content:e.slice(1)}),l++,a++;else if(e?.startsWith(`-`))t.changes.push({type:`delete`,line:i,content:e.slice(1)}),u++,i++;else if(e?.startsWith(` `))t.changes.push({type:`context`,line:a,content:e.slice(1)}),i++,a++;else break;r++}}else r++}let d=s===`deleted`?a:o;t.push({path:d,oldPath:s===`renamed`?a:void 0,status:s,hunks:c,additions:l,deletions:u})}return t}export{e as diffParse};
+//# sourceMappingURL=diff-parse.js.map

package/packages/tools/dist/digest.d.ts

@@ -1,53 +1,51 @@
-/**
- * kb_digest — Multi-source context compressor.
- *
- * Compress N text blocks into a token-budgeted digest with source attribution
- * and pinned structured fields. Uses embedding similarity — no LLM needed.
- */
-import type { IEmbedder } from '@kb/embeddings';
-export interface DigestSource {
-    /** Unique identifier for this source */
-    id: string;
-    /** The text to compress */
-    text: string;
-    /** Priority weight (default: 1). Higher = more budget share */
-    weight?: number;
+import { IEmbedder } from "@kb/embeddings";
+
+//#region packages/tools/src/digest.d.ts
+interface DigestSource {
+  /** Unique identifier for this source */
+  id: string;
+  /** The text to compress */
+  text: string;
+  /** Priority weight (default: 1). Higher = more budget share */
+  weight?: number;
 }
-export interface DigestOptions {
-    /** Source texts to compress */
-    sources: DigestSource[];
-    /** Focus query — what matters for the next step? */
-    query: string;
-    /** Target budget in characters (default: 4000) */
-    maxChars?: number;
-    /** Key fields to always extract via keyword matching */
-    pinFields?: string[];
-    /** Segmentation strategy (default: 'paragraph') */
-    segmentation?: 'paragraph' | 'sentence' | 'line';
+interface DigestOptions {
+  /** Source texts to compress */
+  sources: DigestSource[];
+  /** Focus query — what matters for the next step? */
+  query: string;
+  /** Target budget in characters (default: 4000) */
+  maxChars?: number;
+  /** Key fields to always extract via keyword matching */
+  pinFields?: string[];
+  /** Segmentation strategy (default: 'paragraph') */
+  segmentation?: 'paragraph' | 'sentence' | 'line';
 }
-export interface DigestFieldEntry {
-    sourceId: string;
-    value: string;
+interface DigestFieldEntry {
+  sourceId: string;
+  value: string;
 }
-export interface DigestResult {
-    /** Compressed narrative (all sources merged, reading order maintained) */
-    text: string;
-    /** Extracted structured fields */
-    fields: Record<string, DigestFieldEntry[]>;
-    /** Per-source compression stats */
-    sourceStats: Array<{
-        id: string;
-        originalChars: number;
-        keptChars: number;
-        segmentsKept: number;
-        segmentsTotal: number;
-    }>;
-    totalOriginalChars: number;
-    totalCompressedChars: number;
-    ratio: number;
+interface DigestResult {
+  /** Compressed narrative (all sources merged, reading order maintained) */
+  text: string;
+  /** Extracted structured fields */
+  fields: Record<string, DigestFieldEntry[]>;
+  /** Per-source compression stats */
+  sourceStats: Array<{
+    id: string;
+    originalChars: number;
+    keptChars: number;
+    segmentsKept: number;
+    segmentsTotal: number;
+  }>;
+  totalOriginalChars: number;
+  totalCompressedChars: number;
+  ratio: number;
 }
 /**
  * Compress multiple text sources into a single digest.
  */
-export declare function digest(embedder: IEmbedder, options: DigestOptions): Promise<DigestResult>;
+declare function digest(embedder: IEmbedder, options: DigestOptions): Promise<DigestResult>;
+//#endregion
+export { DigestFieldEntry, DigestOptions, DigestResult, DigestSource, digest };
 //# sourceMappingURL=digest.d.ts.map

package/packages/tools/dist/digest.js

@@ -1,7 +1,7 @@
-import{cosineSimilarity as I,estimateTokens as k,segment as N}from"./text-utils.js";const L=["status","files","decisions","blockers","artifacts","next"],O={status:/\b(?:status|result)\s*[:=]/i,files:/\b(?:files?|modified|created|deleted)\s*[:=]/i,artifacts:/\b(?:artifacts?)\s*[:=]/i,decisions:/\b(?:decisions?|decided|chose|selected)\s*[:=]/i,blockers:/\b(?:blockers?|blocked|blocking)\s*[:=]/i,next:/\b(?:next\s*(?:steps?|actions?)|todo|follow.up)\s*[:=]/i},$={status:/(?:^|\b)(?:status|result)\s*[:=]\s*(.+)$/i,files:/(?:^|\b)(?:files?|modified|created|deleted)\s*[:=]\s*(.+)$/i,artifacts:/(?:^|\b)(?:artifacts?)\s*[:=]\s*(.+)$/i,decisions:/(?:^|\b)(?:decisions?|decided|chose|selected)\s*[:=]\s*(.+)$/i,blockers:/(?:^|\b)(?:blockers?|blocked|blocking)\s*[:=]\s*(.+)$/i,next:/(?:^|\b)(?:next\s*(?:steps?|actions?)|todo|follow.up)\s*[:=]\s*(.+)$/i},R=/\b(?:APPROVED|NEEDS_REVISION|BLOCKED|SUCCESS|PARTIAL|FAILED|ESCALATE)\b/i,b=.01;function M(e){const n=e??[...L];return[...new Set(n.map(r=>r.toLowerCase()))]}function _(e){return typeof e!="number"||!Number.isFinite(e)||e<=0?1:e}function K(e,n){const r=new Set;for(const i of n)O[i]?.test(e)&&r.add(i);return n.includes("status")&&R.test(e)&&r.add("status"),[...r]}function V(e,n){const r=n.split(`
-`).map(i=>i.trim()).filter(i=>i.length>0);for(const i of r){const g=$[e]?.exec(i);if(g?.[1])return g[1].trim();if(e==="status"){const m=i.match(R);if(m)return m[0]}}return n.trim()}function q(e,n,r,i){e[n]||(e[n]=[]),e[n].push({sourceId:r,value:i})}function U(e,n,r,i){return e.map(d=>{const g=N(d.text,n).map((s,o)=>{const l=K(s,r);for(const h of l)q(i,h,d.id,V(h,s));return{index:o,text:s,pinnedFields:l,score:0}}),m=g.filter(s=>s.pinnedFields.length>0).reduce((s,o)=>s+o.text.length,0),f=g.filter(s=>s.pinnedFields.length===0).reduce((s,o)=>s+o.text.length,0);return{id:d.id,originalText:d.text,weight:_(d.weight),segments:g,pinnedChars:m,nonPinnedChars:f}})}function j(e,n){const r=new Map(e.map(g=>[g.id,0]));let i=Math.max(0,n),d=e.filter(g=>g.nonPinnedChars>0);for(;i>b&&d.length>0;){const g=d.reduce((s,o)=>s+o.weight,0);let m=0;const f=[];for(const s of d){const o=r.get(s.id)??0,l=s.nonPinnedChars-o;if(l<=b)continue;const h=i*(s.weight/g),x=Math.min(h,l);r.set(s.id,o+x),m+=x,l-x>b&&f.push(s)}if(m<=b)break;i-=m,d=f}return r}function A(e){return e.map(n=>`[${n.id}]
-${n.text}`).join(`
+import{cosineSimilarity as e,estimateTokens as t,segment as n}from"./text-utils.js";const r=[`status`,`files`,`decisions`,`blockers`,`artifacts`,`next`],i={status:/\b(?:status|result)\s*[:=]/i,files:/\b(?:files?|modified|created|deleted)\s*[:=]/i,artifacts:/\b(?:artifacts?)\s*[:=]/i,decisions:/\b(?:decisions?|decided|chose|selected)\s*[:=]/i,blockers:/\b(?:blockers?|blocked|blocking)\s*[:=]/i,next:/\b(?:next\s*(?:steps?|actions?)|todo|follow.up)\s*[:=]/i},a={status:/(?:^|\b)(?:status|result)\s*[:=]\s*(.+)$/i,files:/(?:^|\b)(?:files?|modified|created|deleted)\s*[:=]\s*(.+)$/i,artifacts:/(?:^|\b)(?:artifacts?)\s*[:=]\s*(.+)$/i,decisions:/(?:^|\b)(?:decisions?|decided|chose|selected)\s*[:=]\s*(.+)$/i,blockers:/(?:^|\b)(?:blockers?|blocked|blocking)\s*[:=]\s*(.+)$/i,next:/(?:^|\b)(?:next\s*(?:steps?|actions?)|todo|follow.up)\s*[:=]\s*(.+)$/i},o=/\b(?:APPROVED|NEEDS_REVISION|BLOCKED|SUCCESS|PARTIAL|FAILED|ESCALATE)\b/i,s=.01;function c(e){let t=e??[...r];return[...new Set(t.map(e=>e.toLowerCase()))]}function l(e){return typeof e!=`number`||!Number.isFinite(e)||e<=0?1:e}function u(e,t){let n=new Set;for(let r of t)i[r]?.test(e)&&n.add(r);return t.includes(`status`)&&o.test(e)&&n.add(`status`),[...n]}function d(e,t){let n=t.split(`
+`).map(e=>e.trim()).filter(e=>e.length>0);for(let t of n){let n=a[e]?.exec(t);if(n?.[1])return n[1].trim();if(e===`status`){let e=t.match(o);if(e)return e[0]}}return t.trim()}function f(e,t,n,r){e[t]||(e[t]=[]),e[t].push({sourceId:n,value:r})}function p(e,t,r,i){return e.map(e=>{let a=n(e.text,t).map((t,n)=>{let a=u(t,r);for(let n of a)f(i,n,e.id,d(n,t));return{index:n,text:t,pinnedFields:a,score:0}}),o=a.filter(e=>e.pinnedFields.length>0).reduce((e,t)=>e+t.text.length,0),s=a.filter(e=>e.pinnedFields.length===0).reduce((e,t)=>e+t.text.length,0);return{id:e.id,originalText:e.text,weight:l(e.weight),segments:a,pinnedChars:o,nonPinnedChars:s}})}function m(e,t){let n=new Map(e.map(e=>[e.id,0])),r=Math.max(0,t),i=e.filter(e=>e.nonPinnedChars>0);for(;r>s&&i.length>0;){let e=i.reduce((e,t)=>e+t.weight,0),t=0,a=[];for(let o of i){let i=n.get(o.id)??0,c=o.nonPinnedChars-i;if(c<=s)continue;let l=r*(o.weight/e),u=Math.min(l,c);n.set(o.id,i+u),t+=u,c-u>s&&a.push(o)}if(t<=s)break;r-=t,i=a}return n}function h(e){return e.map(e=>`[${e.id}]\n${e.text}`).join(`
 
-`)}function B(e,n){return e===0?0:n/e}async function z(e,n){const{sources:r,query:i,maxChars:d=4e3,pinFields:g,segmentation:m="paragraph"}=n,f={},s=M(g),o=U(r,m,s,f),l=r.reduce((c,u)=>c+u.text.length,0);if(l<=d){const c=o.filter(a=>a.originalText.trim().length>0).map(a=>({id:a.id,text:a.originalText})),u=o.map(a=>({id:a.id,originalChars:a.originalText.length,keptChars:a.originalText.length,segmentsKept:a.segments.length,segmentsTotal:a.segments.length}));return{text:A(c),fields:f,sourceStats:u,totalOriginalChars:l,totalCompressedChars:l,ratio:l===0?0:1}}const h=await e.embedQuery(i);for(const c of o)for(const u of c.segments){if(u.pinnedFields.length>0)continue;const a=await e.embed(u.text);u.score=I(h,a)}const x=o.reduce((c,u)=>c+u.pinnedChars,0),w=j(o,d-x),T=[],y=[];let P=0;for(const c of o){const u=w.get(c.id)??0,a=new Map;let C=0;const v=c.segments.filter(t=>t.pinnedFields.length===0).sort((t,p)=>p.score-t.score||k(t.text)-k(p.text)||t.index-p.index);let S;for(const t of v){const p=u-C;if(p<=b)break;if(t.text.length<=p+b){a.set(t.index,t.text),C+=t.text.length;continue}S||(S=t)}const F=Math.floor(u-C);if(S&&F>0){const t=S.text.slice(0,F).trimEnd();t.length>0&&(a.set(S.index,t),C+=t.length)}const E=c.segments.filter(t=>t.pinnedFields.length>0||a.has(t.index)).map(t=>({index:t.index,text:a.get(t.index)??t.text})),D=E.reduce((t,p)=>t+p.text.length,0);T.push({id:c.id,originalChars:c.originalText.length,keptChars:D,segmentsKept:E.length,segmentsTotal:c.segments.length}),P+=D,E.length!==0&&y.push({id:c.id,text:E.map(t=>t.text).join(`
+`)}function g(e,t){return e===0?0:t/e}async function _(n,r){let{sources:i,query:a,maxChars:o=4e3,pinFields:l,segmentation:u=`paragraph`}=r,d={},f=p(i,u,c(l),d),_=i.reduce((e,t)=>e+t.text.length,0);if(_<=o){let e=f.filter(e=>e.originalText.trim().length>0).map(e=>({id:e.id,text:e.originalText})),t=f.map(e=>({id:e.id,originalChars:e.originalText.length,keptChars:e.originalText.length,segmentsKept:e.segments.length,segmentsTotal:e.segments.length}));return{text:h(e),fields:d,sourceStats:t,totalOriginalChars:_,totalCompressedChars:_,ratio:_===0?0:1}}let v=await n.embedQuery(a);for(let t of f)for(let r of t.segments)r.pinnedFields.length>0||(r.score=e(v,await n.embed(r.text)));let y=m(f,o-f.reduce((e,t)=>e+t.pinnedChars,0)),b=[],x=[],S=0;for(let e of f){let n=y.get(e.id)??0,r=new Map,i=0,a=e.segments.filter(e=>e.pinnedFields.length===0).sort((e,n)=>n.score-e.score||t(e.text)-t(n.text)||e.index-n.index),o;for(let e of a){let t=n-i;if(t<=s)break;if(e.text.length<=t+s){r.set(e.index,e.text),i+=e.text.length;continue}o||=e}let c=Math.floor(n-i);if(o&&c>0){let e=o.text.slice(0,c).trimEnd();e.length>0&&(r.set(o.index,e),i+=e.length)}let l=e.segments.filter(e=>e.pinnedFields.length>0||r.has(e.index)).map(e=>({index:e.index,text:r.get(e.index)??e.text})),u=l.reduce((e,t)=>e+t.text.length,0);b.push({id:e.id,originalChars:e.originalText.length,keptChars:u,segmentsKept:l.length,segmentsTotal:e.segments.length}),S+=u,l.length!==0&&x.push({id:e.id,text:l.map(e=>e.text).join(`
 
-`)})}return{text:A(y),fields:f,sourceStats:T,totalOriginalChars:l,totalCompressedChars:P,ratio:B(l,P)}}export{z as digest};
+`)})}return{text:h(x),fields:d,sourceStats:b,totalOriginalChars:_,totalCompressedChars:S,ratio:g(_,S)}}export{_ as digest};
+//# sourceMappingURL=digest.js.map

package/packages/tools/dist/encode.d.ts

@@ -1,14 +1,17 @@
+//#region packages/tools/src/encode.d.ts
 /**
  * kb_encode — Encoding, decoding, and hashing utilities.
  */
-export type EncodeOperation = 'base64_encode' | 'base64_decode' | 'url_encode' | 'url_decode' | 'sha256' | 'md5' | 'jwt_decode' | 'hex_encode' | 'hex_decode';
-export interface EncodeOptions {
-    operation: EncodeOperation;
-    input: string;
+type EncodeOperation = 'base64_encode' | 'base64_decode' | 'url_encode' | 'url_decode' | 'sha256' | 'md5' | 'jwt_decode' | 'hex_encode' | 'hex_decode';
+interface EncodeOptions {
+  operation: EncodeOperation;
+  input: string;
 }
-export interface EncodeResult {
-    output: string;
-    operation: string;
+interface EncodeResult {
+  output: string;
+  operation: string;
 }
-export declare function encode(options: EncodeOptions): EncodeResult;
+declare function encode(options: EncodeOptions): EncodeResult;
+//#endregion
+export { EncodeOperation, EncodeOptions, EncodeResult, encode };
 //# sourceMappingURL=encode.d.ts.map

package/packages/tools/dist/encode.js

@@ -1 +1,2 @@
-import{createHash as n}from"node:crypto";function i(a){const{operation:t,input:o}=a;let e;switch(t){case"base64_encode":e=Buffer.from(o).toString("base64");break;case"base64_decode":e=Buffer.from(o,"base64").toString("utf8");break;case"url_encode":e=encodeURIComponent(o);break;case"url_decode":e=decodeURIComponent(o);break;case"sha256":e=n("sha256").update(o).digest("hex");break;case"md5":e=n("md5").update(o).digest("hex");break;case"jwt_decode":{const r=o.split(".");if(r.length!==3)throw new Error("Invalid JWT: expected 3 dot-separated parts");const d=JSON.parse(Buffer.from(r[0],"base64url").toString()),s=JSON.parse(Buffer.from(r[1],"base64url").toString());e=JSON.stringify({header:d,payload:s},null,2);break}case"hex_encode":e=Buffer.from(o).toString("hex");break;case"hex_decode":e=Buffer.from(o,"hex").toString("utf8");break;default:throw new Error(`Unknown operation: ${t}`)}return{output:e,operation:t}}export{i as encode};
+import{createHash as e}from"node:crypto";function t(t){let{operation:n,input:r}=t,i;switch(n){case`base64_encode`:i=Buffer.from(r).toString(`base64`);break;case`base64_decode`:i=Buffer.from(r,`base64`).toString(`utf8`);break;case`url_encode`:i=encodeURIComponent(r);break;case`url_decode`:i=decodeURIComponent(r);break;case`sha256`:i=e(`sha256`).update(r).digest(`hex`);break;case`md5`:i=e(`md5`).update(r).digest(`hex`);break;case`jwt_decode`:{let e=r.split(`.`);if(e.length!==3)throw Error(`Invalid JWT: expected 3 dot-separated parts`);let t,n;try{t=JSON.parse(Buffer.from(e[0],`base64url`).toString()),n=JSON.parse(Buffer.from(e[1],`base64url`).toString())}catch{throw Error(`Invalid JWT: header or payload is not valid JSON`)}i=JSON.stringify({header:t,payload:n},null,2);break}case`hex_encode`:i=Buffer.from(r).toString(`hex`);break;case`hex_decode`:i=Buffer.from(r,`hex`).toString(`utf8`);break;default:throw Error(`Unknown operation: ${n}`)}return{output:i,operation:n}}export{t as encode};
+//# sourceMappingURL=encode.js.map

package/packages/tools/dist/env-info.d.ts

@@ -1,28 +1,31 @@
+//#region packages/tools/src/env-info.d.ts
 /**
  * kb_env — System environment and runtime information.
  */
-export interface EnvInfoOptions {
-    includeEnv?: boolean;
-    filterEnv?: string;
-    showSensitive?: boolean;
+interface EnvInfoOptions {
+  includeEnv?: boolean;
+  filterEnv?: string;
+  showSensitive?: boolean;
 }
-export interface EnvInfoResult {
-    system: {
-        platform: string;
-        arch: string;
-        release: string;
-        hostname: string;
-        type: string;
-        cpus: number;
-        memoryTotalGb: number;
-        memoryFreeGb: number;
-    };
-    runtime: {
-        node: string;
-        v8: string;
-    };
-    cwd: string;
-    env?: Record<string, string>;
+interface EnvInfoResult {
+  system: {
+    platform: string;
+    arch: string;
+    release: string;
+    hostname: string;
+    type: string;
+    cpus: number;
+    memoryTotalGb: number;
+    memoryFreeGb: number;
+  };
+  runtime: {
+    node: string;
+    v8: string;
+  };
+  cwd: string;
+  env?: Record<string, string>;
 }
-export declare function envInfo(options?: EnvInfoOptions): EnvInfoResult;
+declare function envInfo(options?: EnvInfoOptions): EnvInfoResult;
+//#endregion
+export { EnvInfoOptions, EnvInfoResult, envInfo };
 //# sourceMappingURL=env-info.d.ts.map

package/packages/tools/dist/env-info.js

@@ -1 +1,2 @@
-import{arch as m,cpus as l,freemem as f,hostname as p,type as v,platform as u,release as d,totalmem as g}from"node:os";const E=[/key/i,/secret/i,/token/i,/password/i,/passwd/i,/credential/i,/private/i,/certificate/i];function h(o={}){const{includeEnv:i=!1,filterEnv:t,showSensitive:c=!1}=o,s={system:{platform:u(),arch:m(),release:d(),hostname:p(),type:v(),cpus:l().length,memoryTotalGb:Math.round(g()/1024**3*10)/10,memoryFreeGb:Math.round(f()/1024**3*10)/10},runtime:{node:process.versions.node,v8:process.versions.v8},cwd:process.cwd()};if(i){const n={};for(const[e,r]of Object.entries(process.env))r&&(t&&!e.toLowerCase().includes(t.toLowerCase())||(!c&&E.some(a=>a.test(e))?n[e]="[REDACTED]":n[e]=r));s.env=n}return s}export{h as envInfo};
+import{arch as e,cpus as t,freemem as n,hostname as r,platform as i,release as a,totalmem as o,type as s}from"node:os";const c=[/key/i,/secret/i,/token/i,/password/i,/passwd/i,/credential/i,/private/i,/certificate/i];function l(l={}){let{includeEnv:u=!1,filterEnv:d,showSensitive:f=!1}=l,p={system:{platform:i(),arch:e(),release:a(),hostname:r(),type:s(),cpus:t().length,memoryTotalGb:Math.round(o()/1024**3*10)/10,memoryFreeGb:Math.round(n()/1024**3*10)/10},runtime:{node:process.versions.node,v8:process.versions.v8},cwd:process.cwd()};if(u){let e={};for(let[t,n]of Object.entries(process.env))n&&(d&&!t.toLowerCase().includes(d.toLowerCase())||(!f&&c.some(e=>e.test(t))?e[t]=`[REDACTED]`:e[t]=n));p.env=e}return p}export{l as envInfo};
+//# sourceMappingURL=env-info.js.map

package/packages/tools/dist/eval.d.ts

@@ -1,13 +1,16 @@
-export interface EvalOptions {
-    code: string;
-    lang?: 'js' | 'ts';
-    timeout?: number;
+//#region packages/tools/src/eval.d.ts
+interface EvalOptions {
+  code: string;
+  lang?: 'js' | 'ts';
+  timeout?: number;
 }
-export interface EvalResult {
-    success: boolean;
-    output: string;
-    error?: string;
-    durationMs: number;
+interface EvalResult {
+  success: boolean;
+  output: string;
+  error?: string;
+  durationMs: number;
 }
-export declare function evaluate(options: EvalOptions): EvalResult;
+declare function evaluate(options: EvalOptions): EvalResult;
+//#endregion
+export { EvalOptions, EvalResult, evaluate };
 //# sourceMappingURL=eval.d.ts.map

package/packages/tools/dist/eval.js

@@ -1,3 +1,3 @@
-import u from"node:vm";function w(e){const{code:o,lang:c="js",timeout:p=5e3}=e,i=Date.now();try{const s=c==="ts"?g(o):o,n=[],l={console:{log:(...t)=>n.push(t.map(String).join(" ")),error:(...t)=>n.push(`[error] ${t.map(String).join(" ")}`),warn:(...t)=>n.push(`[warn] ${t.map(String).join(" ")}`)},setTimeout:void 0,setInterval:void 0,setImmediate:void 0,fetch:void 0,process:void 0,require:void 0,JSON,Math,Date,Array,Object,String,Number,Boolean,Map,Set,RegExp,Error,Promise,parseInt,parseFloat,isNaN,isFinite},d=u.createContext(l,{codeGeneration:{strings:!1,wasm:!1}}),r=u.runInContext(s,d,{timeout:p});return{success:!0,output:n.length>0?n.join(`
-`)+(r!==void 0?`
-\u2192 ${a(r)}`:""):r!==void 0?a(r):"(no output)",durationMs:Date.now()-i}}catch(s){return{success:!1,output:"",error:s.message,durationMs:Date.now()-i}}}function a(e){if(e===void 0)return"undefined";if(e===null)return"null";if(typeof e=="object")try{return JSON.stringify(e,null,2)}catch{return String(e)}return String(e)}function g(e){return e.replace(/^\s*import\s+type\s+.*?;\s*$/gm,"").replace(/^\s*(?:export\s+)?interface\s+\w+[^{]*\{[\s\S]*?^\s*}\s*$/gm,"").replace(/^\s*(?:export\s+)?type\s+\w+\s*=.*?;\s*$/gm,"").replace(/([,(]\s*[A-Za-z_$][\w$]*)\s*:\s*[^,)=\n]+/g,"$1").replace(/\)\s*:\s*[^={\n]+(?=\s*(?:=>|\{))/g,")").replace(/\s+as\s+[A-Za-z_$][\w$<>,[\]|&\s.]*/g,"").replace(/<(?:[A-Za-z_$][\w$]*\s*,?\s*)+>(?=\s*\()/g,"")}export{w as evaluate};
+import e from"node:vm";function t(t){let{code:i,lang:a=`js`,timeout:o=5e3}=t,s=Date.now();try{let t=a===`ts`?r(i):i,c=[],l={console:{log:(...e)=>c.push(e.map(String).join(` `)),error:(...e)=>c.push(`[error] ${e.map(String).join(` `)}`),warn:(...e)=>c.push(`[warn] ${e.map(String).join(` `)}`)},setTimeout:void 0,setInterval:void 0,setImmediate:void 0,fetch:void 0,process:void 0,require:void 0,JSON,Math,Date,Array,Object,String,Number,Boolean,Map,Set,RegExp,Error,Promise,parseInt,parseFloat,isNaN,isFinite},u=e.createContext(l,{codeGeneration:{strings:!1,wasm:!1}}),d=e.runInContext(t,u,{timeout:o});return{success:!0,output:c.length>0?c.join(`
+`)+(d===void 0?``:`\n→ ${n(d)}`):d===void 0?`(no output)`:n(d),durationMs:Date.now()-s}}catch(e){return{success:!1,output:``,error:e.message,durationMs:Date.now()-s}}}function n(e){if(e===void 0)return`undefined`;if(e===null)return`null`;if(typeof e==`object`)try{return JSON.stringify(e,null,2)}catch{return String(e)}return String(e)}function r(e){return e.replace(/^\s*import\s+type\s+.*?;\s*$/gm,``).replace(/^\s*(?:export\s+)?interface\s+\w+[^{]*\{[\s\S]*?^\s*}\s*$/gm,``).replace(/^\s*(?:export\s+)?type\s+\w+\s*=.*?;\s*$/gm,``).replace(/([,(]\s*[A-Za-z_$][\w$]*)\s*:\s*[^,)=\n]+/g,`$1`).replace(/\)\s*:\s*[^={\n]+(?=\s*(?:=>|\{))/g,`)`).replace(/\s+as\s+[A-Za-z_$][\w$<>,[\]|&\s.]*/g,``).replace(/<(?:[A-Za-z_$][\w$]*\s*,?\s*)+>(?=\s*\()/g,``)}export{t as evaluate};
+//# sourceMappingURL=eval.js.map

package/packages/tools/dist/evidence-map.d.ts

@@ -1,79 +1,82 @@
+//#region packages/tools/src/evidence-map.d.ts
 /**
  * kb_evidence_map — FORGE Evidence Map CRUD + Gate evaluator.
  *
  * Structured storage, validation, and gate evaluation for FORGE Evidence Map entries.
  * Persisted in .kb-state/evidence-maps.json.
  */
-export type EvidenceStatus = 'V' | 'A' | 'U';
-export type UnknownType = 'contract' | 'convention' | 'freshness' | 'runtime' | 'data-flow' | 'impact';
-export type GateDecision = 'YIELD' | 'HOLD' | 'HARD_BLOCK' | 'FORCED_DELIVERY';
-export type ForgeTier = 'floor' | 'standard' | 'critical';
-export interface EvidenceEntry {
-    id: number;
-    claim: string;
-    status: EvidenceStatus;
-    receipt: string;
-    criticalPath: boolean;
-    unknownType?: UnknownType;
+type EvidenceStatus = 'V' | 'A' | 'U';
+type UnknownType = 'contract' | 'convention' | 'freshness' | 'runtime' | 'data-flow' | 'impact';
+type GateDecision = 'YIELD' | 'HOLD' | 'HARD_BLOCK' | 'FORCED_DELIVERY';
+type ForgeTier = 'floor' | 'standard' | 'critical';
+interface EvidenceEntry {
+  id: number;
+  claim: string;
+  status: EvidenceStatus;
+  receipt: string;
+  criticalPath: boolean;
+  unknownType?: UnknownType;
 }
-export interface EvidenceMapState {
-    taskId: string;
-    tier: ForgeTier;
-    entries: EvidenceEntry[];
-    createdAt: string;
-    updatedAt: string;
+interface EvidenceMapState {
+  taskId: string;
+  tier: ForgeTier;
+  entries: EvidenceEntry[];
+  createdAt: string;
+  updatedAt: string;
 }
-export interface GateResult {
-    decision: GateDecision;
-    reason: string;
-    unresolvedCritical: EvidenceEntry[];
-    warnings: string[];
-    stats: {
-        total: number;
-        verified: number;
-        assumed: number;
-        unresolved: number;
-    };
-    annotation?: string;
+interface GateResult {
+  decision: GateDecision;
+  reason: string;
+  unresolvedCritical: EvidenceEntry[];
+  warnings: string[];
+  stats: {
+    total: number;
+    verified: number;
+    assumed: number;
+    unresolved: number;
+  };
+  annotation?: string;
 }
-export type EvidenceMapAction = {
-    action: 'create';
-    taskId: string;
-    tier: ForgeTier;
+type EvidenceMapAction = {
+  action: 'create';
+  taskId: string;
+  tier: ForgeTier;
 } | {
-    action: 'add';
-    taskId: string;
-    claim: string;
-    status: EvidenceStatus;
-    receipt: string;
-    criticalPath?: boolean;
-    unknownType?: UnknownType;
+  action: 'add';
+  taskId: string;
+  claim: string;
+  status: EvidenceStatus;
+  receipt: string;
+  criticalPath?: boolean;
+  unknownType?: UnknownType;
 } | {
-    action: 'update';
-    taskId: string;
-    id: number;
-    status: EvidenceStatus;
-    receipt: string;
+  action: 'update';
+  taskId: string;
+  id: number;
+  status: EvidenceStatus;
+  receipt: string;
 } | {
-    action: 'get';
-    taskId: string;
+  action: 'get';
+  taskId: string;
 } | {
-    action: 'gate';
-    taskId: string;
-    retryCount?: number;
+  action: 'gate';
+  taskId: string;
+  retryCount?: number;
 } | {
-    action: 'list';
+  action: 'list';
 } | {
-    action: 'delete';
-    taskId: string;
+  action: 'delete';
+  taskId: string;
 };
-export interface EvidenceMapResult {
-    state?: EvidenceMapState;
-    states?: EvidenceMapState[];
-    entry?: EvidenceEntry;
-    gate?: GateResult;
-    deleted?: boolean;
-    formattedMap?: string;
+interface EvidenceMapResult {
+  state?: EvidenceMapState;
+  states?: EvidenceMapState[];
+  entry?: EvidenceEntry;
+  gate?: GateResult;
+  deleted?: boolean;
+  formattedMap?: string;
 }
-export declare function evidenceMap(action: EvidenceMapAction, cwd?: string): EvidenceMapResult;
+declare function evidenceMap(action: EvidenceMapAction, cwd?: string): EvidenceMapResult;
+//#endregion
+export { EvidenceEntry, EvidenceMapAction, EvidenceMapResult, EvidenceMapState, EvidenceStatus, ForgeTier, GateDecision, GateResult, UnknownType, evidenceMap };
 //# sourceMappingURL=evidence-map.d.ts.map

package/packages/tools/dist/evidence-map.js

@@ -1,3 +1,3 @@
-import{existsSync as p,mkdirSync as g,readFileSync as m,writeFileSync as v}from"node:fs";import{dirname as E,resolve as y}from"node:path";const h=".kb-state",k="evidence-maps.json";function f(t){const n=t??process.cwd();return y(n,h,k)}function o(t){const n=f(t);if(!p(n))return{};const e=m(n,"utf-8");return JSON.parse(e)}function c(t,n){const e=f(n),r=E(e);p(r)||g(r,{recursive:!0}),v(e,`${JSON.stringify(t,null,2)}
-`,"utf-8")}function d(t,n){const e=o(n),r=e[t];if(!r)throw new Error(`Evidence map not found: ${t}`);return{maps:e,state:r}}function S(t){return t.reduce((n,e)=>Math.max(n,e.id),0)+1}function M(t){const n=t.trim();if(!n)throw new Error("Claim is required");if(/\r?\n/.test(n))throw new Error("Claim must be a single line");return n}function u(t){return(t??"").replace(/\r?\n/g," ").replace(/\|/g,"\\|")}function s(t){const n=["| # | Claim | Status | Receipt | Critical | Type |","|---|-------|--------|---------|----------|------|"];for(const e of t.entries)n.push(`| ${e.id} | ${u(e.claim)} | ${e.status} | ${u(e.receipt)} | ${e.criticalPath?"yes":"no"} | ${u(e.unknownType)} |`);return n.join(`
-`)}function I(t){return{total:t.length,verified:t.filter(n=>n.status==="V").length,assumed:t.filter(n=>n.status==="A").length,unresolved:t.filter(n=>n.status==="U").length}}function w(t){const n=[];for(const e of t.entries)e.status==="V"&&e.receipt.trim()===""&&n.push("V entry without receipt"),e.status==="A"&&t.tier==="critical"&&e.unknownType==="contract"&&n.push("Assumed contract at Critical tier \u2014 should be Verified");return n}function b(t){return`FORCED DELIVERY annotation: unresolved entries remain -> ${t.filter(r=>r.status==="U").map(r=>`#${r.id} ${r.claim}`).join("; ")}`}function A(t,n=0){const e=t.entries.filter(a=>a.criticalPath&&a.status==="U"),r=w(t),i=I(t.entries);return e.find(a=>a.unknownType==="contract")?{decision:"HARD_BLOCK",reason:"Unresolved contract unknown on critical path",unresolvedCritical:e,warnings:r,stats:i}:e.length>0&&n===0?{decision:"HOLD",reason:"Unresolved critical-path unknown \u2014 retry available",unresolvedCritical:e,warnings:r,stats:i}:e.length>0&&n>=1?{decision:"FORCED_DELIVERY",reason:"Unresolved critical-path unknown after retry",unresolvedCritical:e,warnings:r,stats:i,annotation:b(t.entries)}:{decision:"YIELD",reason:"All critical-path claims satisfy gate rules",unresolvedCritical:[],warnings:r,stats:i}}function D(t,n){switch(t.action){case"create":{const e=o(n),r=new Date().toISOString(),i={taskId:t.taskId,tier:t.tier,entries:[],createdAt:r,updatedAt:r};return e[t.taskId]=i,c(e,n),{state:i,formattedMap:s(i)}}case"add":{const{maps:e,state:r}=d(t.taskId,n),i={id:S(r.entries),claim:M(t.claim),status:t.status,receipt:t.receipt,criticalPath:t.criticalPath??!1,unknownType:t.unknownType};return r.entries.push(i),r.updatedAt=new Date().toISOString(),e[t.taskId]=r,c(e,n),{state:r,entry:i,formattedMap:s(r)}}case"update":{const{maps:e,state:r}=d(t.taskId,n),i=r.entries.find(l=>l.id===t.id);if(!i)throw new Error(`Evidence entry not found: ${t.id}`);return i.status=t.status,i.receipt=t.receipt,r.updatedAt=new Date().toISOString(),e[t.taskId]=r,c(e,n),{state:r,entry:i,formattedMap:s(r)}}case"get":{const{state:e}=d(t.taskId,n);return{state:e,formattedMap:s(e)}}case"gate":{const{state:e}=d(t.taskId,n);return{state:e,gate:A(e,t.retryCount??0),formattedMap:s(e)}}case"list":return{states:Object.values(o(n)).sort((r,i)=>r.createdAt.localeCompare(i.createdAt))};case"delete":{const e=o(n);return t.taskId in e?(delete e[t.taskId],c(e,n),{deleted:!0}):{deleted:!1}}}}export{D as evidenceMap};
+import{dirname as e,resolve as t}from"node:path";import{existsSync as n,mkdirSync as r,readFileSync as i,writeFileSync as a}from"node:fs";function o(e){return t(e??process.cwd(),`.kb-state`,`evidence-maps.json`)}function s(e){let t=o(e);if(!n(t))return{};try{let e=i(t,`utf-8`);return JSON.parse(e)}catch{return{}}}function c(t,i){let s=o(i),c=e(s);n(c)||r(c,{recursive:!0}),a(s,`${JSON.stringify(t,null,2)}\n`,`utf-8`)}function l(e,t){let n=s(t),r=n[e];if(!r)throw Error(`Evidence map not found: ${e}`);return{maps:n,state:r}}function u(e){return e.reduce((e,t)=>Math.max(e,t.id),0)+1}function d(e){let t=e.trim();if(!t)throw Error(`Claim is required`);if(/\r?\n/.test(t))throw Error(`Claim must be a single line`);return t}function f(e){return(e??``).replace(/\r?\n/g,` `).replace(/\|/g,`\\|`)}function p(e){let t=[`| # | Claim | Status | Receipt | Critical | Type |`,`|---|-------|--------|---------|----------|------|`];for(let n of e.entries)t.push(`| ${n.id} | ${f(n.claim)} | ${n.status} | ${f(n.receipt)} | ${n.criticalPath?`yes`:`no`} | ${f(n.unknownType)} |`);return t.join(`
+`)}function m(e){return{total:e.length,verified:e.filter(e=>e.status===`V`).length,assumed:e.filter(e=>e.status===`A`).length,unresolved:e.filter(e=>e.status===`U`).length}}function h(e){let t=[];for(let n of e.entries)n.status===`V`&&n.receipt.trim()===``&&t.push(`V entry without receipt`),n.status===`A`&&e.tier===`critical`&&n.unknownType===`contract`&&t.push(`Assumed contract at Critical tier — should be Verified`);return t}function g(e){return`FORCED DELIVERY annotation: unresolved entries remain -> ${e.filter(e=>e.status===`U`).map(e=>`#${e.id} ${e.claim}`).join(`; `)}`}function _(e,t=0){let n=e.entries.filter(e=>e.criticalPath&&e.status===`U`),r=h(e),i=m(e.entries);return n.find(e=>e.unknownType===`contract`)?{decision:`HARD_BLOCK`,reason:`Unresolved contract unknown on critical path`,unresolvedCritical:n,warnings:r,stats:i}:n.length>0&&t===0?{decision:`HOLD`,reason:`Unresolved critical-path unknown — retry available`,unresolvedCritical:n,warnings:r,stats:i}:n.length>0&&t>=1?{decision:`FORCED_DELIVERY`,reason:`Unresolved critical-path unknown after retry`,unresolvedCritical:n,warnings:r,stats:i,annotation:g(e.entries)}:{decision:`YIELD`,reason:`All critical-path claims satisfy gate rules`,unresolvedCritical:[],warnings:r,stats:i}}function v(e,t){switch(e.action){case`create`:{let n=s(t),r=new Date().toISOString(),i={taskId:e.taskId,tier:e.tier,entries:[],createdAt:r,updatedAt:r};return n[e.taskId]=i,c(n,t),{state:i,formattedMap:p(i)}}case`add`:{let{maps:n,state:r}=l(e.taskId,t),i={id:u(r.entries),claim:d(e.claim),status:e.status,receipt:e.receipt,criticalPath:e.criticalPath??!1,unknownType:e.unknownType};return r.entries.push(i),r.updatedAt=new Date().toISOString(),n[e.taskId]=r,c(n,t),{state:r,entry:i,formattedMap:p(r)}}case`update`:{let{maps:n,state:r}=l(e.taskId,t),i=r.entries.find(t=>t.id===e.id);if(!i)throw Error(`Evidence entry not found: ${e.id}`);return i.status=e.status,i.receipt=e.receipt,r.updatedAt=new Date().toISOString(),n[e.taskId]=r,c(n,t),{state:r,entry:i,formattedMap:p(r)}}case`get`:{let{state:n}=l(e.taskId,t);return{state:n,formattedMap:p(n)}}case`gate`:{let{state:n}=l(e.taskId,t);return{state:n,gate:_(n,e.retryCount??0),formattedMap:p(n)}}case`list`:return{states:Object.values(s(t)).sort((e,t)=>e.createdAt.localeCompare(t.createdAt))};case`delete`:{let n=s(t);return e.taskId in n?(delete n[e.taskId],c(n,t),{deleted:!0}):{deleted:!1}}}}export{v as evidenceMap};
+//# sourceMappingURL=evidence-map.js.map

package/packages/tools/dist/file-cache.d.ts

@@ -0,0 +1,42 @@
+//#region packages/tools/src/file-cache.d.ts
+interface FileCacheEntry {
+  /** Full file content */
+  content: string;
+  /** SHA-256 hash of content */
+  hash: string;
+  /** Line count */
+  lines: number;
+  /** Estimated token count (~chars/4) */
+  estimatedTokens: number;
+  /** How many times this file has been requested */
+  hitCount: number;
+  /** Whether content changed since last read (false on cache hit) */
+  changed: boolean;
+}
+interface FileCacheStats {
+  totalReads: number;
+  cacheHits: number;
+  filesTracked: number;
+}
+declare class FileCache {
+  private cache;
+  private totalReads;
+  private cacheHits;
+  private static readonly MAX_ENTRIES;
+  /**
+   * Get file content with deduplication.
+   * First call: reads from disk, hashes, caches.
+   * Subsequent calls: checks mtime → if unchanged, cache hit (skip read).
+   * If mtime changed: re-reads, re-hashes, checks if content actually changed.
+   */
+  get(filePath: string): Promise<FileCacheEntry>;
+  /** Remove a single file from cache. Returns true if it was cached. */
+  invalidate(filePath: string): boolean;
+  /** Clear all cached files. Returns how many were cleared. */
+  clear(): number;
+  /** Get cache statistics. */
+  stats(): FileCacheStats;
+}
+//#endregion
+export { FileCache, FileCacheEntry, FileCacheStats };
+//# sourceMappingURL=file-cache.d.ts.map

package/packages/tools/dist/file-cache.js

@@ -0,0 +1,4 @@
+import{estimateTokens as e}from"./text-utils.js";import{readFile as t,stat as n}from"node:fs/promises";import{resolve as r}from"node:path";import{createHash as i}from"node:crypto";var a=class i{cache=new Map;totalReads=0;cacheHits=0;static MAX_ENTRIES=500;async get(a){let s=r(a);this.totalReads++;let c=(await n(s)).mtimeMs,l=this.cache.get(s);if(l){if(l.mtimeMs===c)return this.cacheHits++,l.hitCount++,{content:l.content,hash:l.hash,lines:l.lines,estimatedTokens:l.estimatedTokens,hitCount:l.hitCount,changed:!1};let n=await t(s,`utf-8`),r=o(n);if(r===l.hash)return this.cacheHits++,l.hitCount++,l.mtimeMs=c,{content:l.content,hash:l.hash,lines:l.lines,estimatedTokens:l.estimatedTokens,hitCount:l.hitCount,changed:!1};let i=n.split(`
+`).length,a=e(n);return l.content=n,l.hash=r,l.lines=i,l.estimatedTokens=a,l.hitCount++,l.mtimeMs=c,{content:n,hash:r,lines:i,estimatedTokens:a,hitCount:l.hitCount,changed:!0}}let u=await t(s,`utf-8`),d=o(u),f=u.split(`
+`).length,p=e(u);if(this.cache.set(s,{content:u,hash:d,lines:f,estimatedTokens:p,hitCount:1,mtimeMs:c}),this.cache.size>i.MAX_ENTRIES){let e=this.cache.keys().next().value;e&&this.cache.delete(e)}return{content:u,hash:d,lines:f,estimatedTokens:p,hitCount:1,changed:!0}}invalidate(e){return this.cache.delete(r(e))}clear(){let e=this.cache.size;return this.cache.clear(),e}stats(){return{totalReads:this.totalReads,cacheHits:this.cacheHits,filesTracked:this.cache.size}}};function o(e){return i(`sha256`).update(e).digest(`hex`)}export{a as FileCache};
+//# sourceMappingURL=file-cache.js.map

package/packages/tools/dist/file-summary.d.ts

@@ -1,32 +1,37 @@
-export interface FileSummaryOptions {
-    path: string;
-    previewLines?: number;
+//#region packages/tools/src/file-summary.d.ts
+interface FileSummaryOptions {
+  path: string;
+  /** Pre-loaded content — skip readFile when provided (e.g., from FileCache) */
+  content?: string;
+  previewLines?: number;
 }
-export interface FileSummaryResult {
-    path: string;
-    lines: number;
-    language: string;
-    imports: string[];
-    exports: string[];
-    functions: Array<{
-        name: string;
-        line: number;
-        exported: boolean;
-    }>;
-    classes: Array<{
-        name: string;
-        line: number;
-        exported: boolean;
-    }>;
-    interfaces: Array<{
-        name: string;
-        line: number;
-    }>;
-    types: Array<{
-        name: string;
-        line: number;
-    }>;
-    estimatedTokens: number;
+interface FileSummaryResult {
+  path: string;
+  lines: number;
+  language: string;
+  imports: string[];
+  exports: string[];
+  functions: Array<{
+    name: string;
+    line: number;
+    exported: boolean;
+  }>;
+  classes: Array<{
+    name: string;
+    line: number;
+    exported: boolean;
+  }>;
+  interfaces: Array<{
+    name: string;
+    line: number;
+  }>;
+  types: Array<{
+    name: string;
+    line: number;
+  }>;
+  estimatedTokens: number;
 }
-export declare function fileSummary(options: FileSummaryOptions): Promise<FileSummaryResult>;
+declare function fileSummary(options: FileSummaryOptions): Promise<FileSummaryResult>;
+//#endregion
+export { FileSummaryOptions, FileSummaryResult, fileSummary };
 //# sourceMappingURL=file-summary.d.ts.map