@vpxa/kb 0.1.13 → 0.1.15

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

@@ -1,45 +1,49 @@
-import { type ParsedError } from './parse-output.js';
-export interface CheckOptions {
-    /** Specific files to check (if empty, checks all) */
-    files?: string[];
-    /** Working directory */
-    cwd?: string;
-    /** Skip typecheck */
-    skipTypes?: boolean;
-    /** Skip lint */
-    skipLint?: boolean;
-    /** Detail level: summary (default, minimal), errors (parsed errors), full (includes raw) */
-    detail?: 'summary' | 'errors' | 'full';
+import { ParsedError } from "./parse-output.js";
+
+//#region packages/tools/src/check.d.ts
+interface CheckOptions {
+  /** Specific files to check (if empty, checks all) */
+  files?: string[];
+  /** Working directory */
+  cwd?: string;
+  /** Skip typecheck */
+  skipTypes?: boolean;
+  /** Skip lint */
+  skipLint?: boolean;
+  /** Detail level: summary (default, minimal), errors (parsed errors), full (includes raw) */
+  detail?: 'summary' | 'errors' | 'full';
 }
-export interface CheckSummaryResult {
+interface CheckSummaryResult {
+  passed: boolean;
+  tsc: {
     passed: boolean;
-    tsc: {
-        passed: boolean;
-        errorCount: number;
-        warningCount: number;
-        topErrors: string[];
-    };
-    biome: {
-        passed: boolean;
-        errorCount: number;
-        warningCount: number;
-        topErrors: string[];
-    };
+    errorCount: number;
+    warningCount: number;
+    topErrors: string[];
+  };
+  biome: {
+    passed: boolean;
+    errorCount: number;
+    warningCount: number;
+    topErrors: string[];
+  };
 }
-export interface CheckResult {
-    tsc: {
-        errors: ParsedError[];
-        passed: boolean;
-        raw?: string;
-    };
-    biome: {
-        errors: ParsedError[];
-        passed: boolean;
-        raw?: string;
-    };
+interface CheckResult {
+  tsc: {
+    errors: ParsedError[];
+    passed: boolean;
+    raw?: string;
+  };
+  biome: {
+    errors: ParsedError[];
     passed: boolean;
+    raw?: string;
+  };
+  passed: boolean;
 }
-export declare function check(options?: CheckOptions): Promise<CheckResult>;
+declare function check(options?: CheckOptions): Promise<CheckResult>;
 /** Produce a minimal summary for LLM consumption (~300 tokens) */
-export declare function summarizeCheckResult(result: CheckResult): CheckSummaryResult;
+declare function summarizeCheckResult(result: CheckResult): CheckSummaryResult;
+//#endregion
+export { CheckOptions, CheckResult, CheckSummaryResult, check, summarizeCheckResult };
 //# sourceMappingURL=check.d.ts.map

package/packages/tools/dist/check.js

@@ -1,2 +1,3 @@
-import{execFile as d}from"node:child_process";import{readFile as m}from"node:fs/promises";import{join as f}from"node:path";import{promisify as g}from"node:util";import{parseBiome as h,parseTsc as b}from"./parse-output.js";const c=g(d);function p(r){const o=r,t=o.stdout?.toString()??"",s=o.stderr?.toString()??"";return[t,s].filter(Boolean).join(`
-`).trim()||o.message||"Command failed"}async function R(r={}){const o=r.cwd??process.cwd(),t={errors:[],passed:!0,raw:""},s={errors:[],passed:!0,raw:""};if(!r.skipTypes)try{const n=f(o,"package.json");let l=!1;try{l=!!JSON.parse(await m(n,"utf-8")).scripts?.typecheck}catch{}if(l&&!r.files?.length)await c("npx",["turbo","run","typecheck"],{cwd:o,shell:!0});else{const i=["--noEmit"];r.files?.length&&i.push(...r.files),await c("npx",["tsc",...i],{cwd:o,shell:!0})}}catch(n){t.raw=p(n),t.errors=b(t.raw),t.passed=t.errors.length===0}if(!r.skipLint)try{const n=["check"];r.files?.length&&n.push(...r.files),await c("npx",["biome",...n],{cwd:o,shell:!0})}catch(n){s.raw=p(n),s.errors=h(s.raw),s.passed=s.errors.length===0}const a=r.detail??"full",e={tsc:t,biome:s,passed:t.passed&&s.passed};return a==="full"?e:a==="errors"?{tsc:{errors:t.errors,passed:t.passed},biome:{errors:s.errors,passed:s.passed},passed:e.passed}:e}const u=3;function x(r){const o=r.tsc.errors.filter(e=>e.severity==="error"),t=r.tsc.errors.filter(e=>e.severity==="warning"),s=r.biome.errors.filter(e=>e.severity==="error"),a=r.biome.errors.filter(e=>e.severity==="warning");return{passed:r.passed,tsc:{passed:r.tsc.passed,errorCount:o.length,warningCount:t.length,topErrors:o.slice(0,u).map(e=>`${e.file}:${e.line} \u2014 ${e.message}`)},biome:{passed:r.biome.passed,errorCount:s.length,warningCount:a.length,topErrors:s.slice(0,u).map(e=>`${e.file}:${e.line} \u2014 ${e.message}`)}}}export{R as check,x as summarizeCheckResult};
+import{parseBiome as e,parseTsc as t}from"./parse-output.js";import{execFile as n}from"node:child_process";import{readFile as r}from"node:fs/promises";import{join as i}from"node:path";import{promisify as a}from"node:util";const o=a(n);let s=0;function c(e){let t=e;return[t.stdout?.toString()??``,t.stderr?.toString()??``].filter(Boolean).join(`
+`).trim()||t.message||`Command failed`}async function l(e={}){if(s>=2)throw Error(`Too many concurrent check runs (max 2). Try again later.`);s++;try{return await u(e)}finally{s--}}async function u(n){let a=n.cwd??process.cwd(),s={errors:[],passed:!0,raw:``},l={errors:[],passed:!0,raw:``};if(!n.skipTypes)try{let e=i(a,`package.json`),t=!1;try{t=!!JSON.parse(await r(e,`utf-8`)).scripts?.typecheck}catch{}if(t&&!n.files?.length)await o(`npx`,[`turbo`,`run`,`typecheck`],{cwd:a,shell:!0,timeout:12e4});else{let e=[`--noEmit`];n.files?.length&&e.push(...n.files),await o(`npx`,[`tsc`,...e],{cwd:a,shell:!0,timeout:12e4})}}catch(e){s.raw=c(e),s.errors=t(s.raw),s.passed=s.errors.length===0}if(!n.skipLint)try{let e=[`check`];n.files?.length&&e.push(...n.files),await o(`npx`,[`biome`,...e],{cwd:a,shell:!0,timeout:12e4})}catch(t){l.raw=c(t),l.errors=e(l.raw),l.passed=l.errors.length===0}let u=n.detail??`full`,d={tsc:s,biome:l,passed:s.passed&&l.passed};return u===`full`?d:u===`errors`?{tsc:{errors:s.errors,passed:s.passed},biome:{errors:l.errors,passed:l.passed},passed:d.passed}:d}function d(e){let t=e.tsc.errors.filter(e=>e.severity===`error`),n=e.tsc.errors.filter(e=>e.severity===`warning`),r=e.biome.errors.filter(e=>e.severity===`error`),i=e.biome.errors.filter(e=>e.severity===`warning`);return{passed:e.passed,tsc:{passed:e.tsc.passed,errorCount:t.length,warningCount:n.length,topErrors:t.slice(0,3).map(e=>`${e.file}:${e.line} — ${e.message}`)},biome:{passed:e.biome.passed,errorCount:r.length,warningCount:i.length,topErrors:r.slice(0,3).map(e=>`${e.file}:${e.line} — ${e.message}`)}}}export{l as check,d as summarizeCheckResult};
+//# sourceMappingURL=check.js.map

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

@@ -1,17 +1,20 @@
-export interface Checkpoint {
-    id: string;
-    label: string;
-    createdAt: string;
-    data: Record<string, unknown>;
-    files?: string[];
-    notes?: string;
+//#region packages/tools/src/checkpoint.d.ts
+interface Checkpoint {
+  id: string;
+  label: string;
+  createdAt: string;
+  data: Record<string, unknown>;
+  files?: string[];
+  notes?: string;
 }
-export declare function checkpointSave(label: string, data: Record<string, unknown>, options?: {
-    files?: string[];
-    notes?: string;
-    cwd?: string;
+declare function checkpointSave(label: string, data: Record<string, unknown>, options?: {
+  files?: string[];
+  notes?: string;
+  cwd?: string;
 }): Checkpoint;
-export declare function checkpointLoad(id: string, cwd?: string): Checkpoint | undefined;
-export declare function checkpointList(cwd?: string): Checkpoint[];
-export declare function checkpointLatest(cwd?: string): Checkpoint | undefined;
+declare function checkpointLoad(id: string, cwd?: string): Checkpoint | undefined;
+declare function checkpointList(cwd?: string): Checkpoint[];
+declare function checkpointLatest(cwd?: string): Checkpoint | undefined;
+//#endregion
+export { Checkpoint, checkpointLatest, checkpointList, checkpointLoad, checkpointSave };
 //# sourceMappingURL=checkpoint.d.ts.map

package/packages/tools/dist/checkpoint.js

@@ -1,2 +1,2 @@
-import{existsSync as s,mkdirSync as d,readdirSync as f,readFileSync as a,writeFileSync as u}from"node:fs";import{resolve as i}from"node:path";const g=".kb-state/checkpoints";function o(n){const e=n??process.cwd(),t=i(e,g);return s(t)||d(t,{recursive:!0}),t}function C(n,e,t){const r=n.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"")||"checkpoint",c={id:`${Date.now()}-${r}`,label:n,createdAt:new Date().toISOString(),data:e,files:t?.files,notes:t?.notes},p=i(o(t?.cwd),`${c.id}.json`);return u(p,`${JSON.stringify(c,null,2)}
-`,"utf-8"),c}function S(n,e){const t=i(o(e),`${n}.json`);if(s(t))return JSON.parse(a(t,"utf-8"))}function k(n){const e=o(n);return f(e).filter(t=>t.endsWith(".json")).map(t=>JSON.parse(a(i(e,t),"utf-8"))).sort((t,r)=>r.createdAt.localeCompare(t.createdAt))}function w(n){return k(n)[0]}export{w as checkpointLatest,k as checkpointList,S as checkpointLoad,C as checkpointSave};
+import{resolve as e}from"node:path";import{existsSync as t,mkdirSync as n,readFileSync as r,readdirSync as i,writeFileSync as a}from"node:fs";function o(r){let i=e(r??process.cwd(),`.kb-state/checkpoints`);return t(i)||n(i,{recursive:!0}),i}function s(t,n,r){let i=t.toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-|-$/g,``)||`checkpoint`,s={id:`${Date.now()}-${i}`,label:t,createdAt:new Date().toISOString(),data:n,files:r?.files,notes:r?.notes};return a(e(o(r?.cwd),`${s.id}.json`),`${JSON.stringify(s,null,2)}\n`,`utf-8`),s}function c(n,i){let a=e(o(i),`${n}.json`);if(t(a))try{return JSON.parse(r(a,`utf-8`))}catch{return}}function l(t){let n=o(t);return i(n).filter(e=>e.endsWith(`.json`)).flatMap(t=>{try{return[JSON.parse(r(e(n,t),`utf-8`))]}catch{return[]}}).sort((e,t)=>t.createdAt.localeCompare(e.createdAt))}function u(e){return l(e)[0]}export{u as checkpointLatest,l as checkpointList,c as checkpointLoad,s as checkpointSave};
+//# sourceMappingURL=checkpoint.js.map

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

@@ -1,37 +1,40 @@
-export interface CodemodRule {
-    /** Description of what this rule does */
-    description: string;
-    /** Regex pattern to match (string form, will be compiled) */
-    pattern: string;
-    /** Replacement string (supports $1, $2 capture groups) */
-    replacement: string;
-    /** Optional: only apply to files matching this glob */
-    fileFilter?: string;
+//#region packages/tools/src/codemod.d.ts
+interface CodemodRule {
+  /** Description of what this rule does */
+  description: string;
+  /** Regex pattern to match (string form, will be compiled) */
+  pattern: string;
+  /** Replacement string (supports $1, $2 capture groups) */
+  replacement: string;
+  /** Optional: only apply to files matching this glob */
+  fileFilter?: string;
 }
-export interface CodemodOptions {
-    /** Root directory to apply codemod in */
-    rootPath: string;
-    /** Rules to apply */
-    rules: CodemodRule[];
-    /** File extensions to process */
-    extensions?: string[];
-    /** Exclude patterns */
-    exclude?: string[];
-    /** Dry run */
-    dryRun?: boolean;
+interface CodemodOptions {
+  /** Root directory to apply codemod in */
+  rootPath: string;
+  /** Rules to apply */
+  rules: CodemodRule[];
+  /** File extensions to process */
+  extensions?: string[];
+  /** Exclude patterns */
+  exclude?: string[];
+  /** Dry run */
+  dryRun?: boolean;
 }
-export interface CodemodChange {
-    rule: string;
-    path: string;
-    line: number;
-    before: string;
-    after: string;
+interface CodemodChange {
+  rule: string;
+  path: string;
+  line: number;
+  before: string;
+  after: string;
 }
-export interface CodemodResult {
-    changes: CodemodChange[];
-    rulesApplied: number;
-    filesModified: number;
-    dryRun: boolean;
+interface CodemodResult {
+  changes: CodemodChange[];
+  rulesApplied: number;
+  filesModified: number;
+  dryRun: boolean;
 }
-export declare function codemod(options: CodemodOptions): Promise<CodemodResult>;
+declare function codemod(options: CodemodOptions): Promise<CodemodResult>;
+//#endregion
+export { CodemodChange, CodemodOptions, CodemodResult, CodemodRule, codemod };
 //# sourceMappingURL=codemod.d.ts.map

package/packages/tools/dist/codemod.js

@@ -1,2 +1,3 @@
-import{readFile as b,writeFile as P}from"node:fs/promises";import{relative as w}from"node:path";import{DEFAULT_TOOL_EXTENSIONS as F,matchesGlobPattern as O,walkFiles as y}from"./file-walk.js";function E(o){return o.replace(/\\/g,"/")}async function v(o){const{rootPath:l,rules:g,extensions:m=F,exclude:h=[],dryRun:a=!1}=o,x=g.map(e=>({...e,regex:new RegExp(e.pattern,"g")})),C=await y(l,m,h),d=[],f=new Set;let c=0;for(const e of C){const u=E(w(l,e)),r=(await b(e,"utf-8")).split(/\r?\n/);let p=!1;for(const[R,t]of x.entries())if(!(t.fileFilter&&!O(u,t.fileFilter)))for(let n=0;n<r.length;n++){const i=r[n];t.regex.lastIndex=0;const s=i.replace(t.regex,t.replacement);i!==s&&(r[n]=s,p=!0,f.add(R),d.push({rule:t.description,path:u,line:n+1,before:i,after:s}))}p&&(c+=1,a||await P(e,r.join(`
-`),"utf-8"))}return{changes:d,rulesApplied:f.size,filesModified:c,dryRun:a}}export{v as codemod};
+import{DEFAULT_TOOL_EXTENSIONS as e,matchesGlobPattern as t,walkFiles as n}from"./file-walk.js";import{readFile as r,writeFile as i}from"node:fs/promises";import{relative as a}from"node:path";function o(e){return e.replace(/\\/g,`/`)}async function s(s){let{rootPath:c,rules:l,extensions:u=e,exclude:d=[],dryRun:f=!1}=s,p=l.map(e=>({...e,regex:new RegExp(e.pattern,`g`)})),m=await n(c,u,d),h=[],g=new Set,_=0;for(let e of m){let n=o(a(c,e)),s=(await r(e,`utf-8`)).split(/\r?\n/),l=!1;for(let[e,r]of p.entries())if(!(r.fileFilter&&!t(n,r.fileFilter)))for(let t=0;t<s.length;t++){let i=s[t];r.regex.lastIndex=0;let a=i.replace(r.regex,r.replacement);i!==a&&(s[t]=a,l=!0,g.add(e),h.push({rule:r.description,path:n,line:t+1,before:i,after:a}))}l&&(_+=1,f||await i(e,s.join(`
+`),`utf-8`))}return{changes:h,rulesApplied:g.size,filesModified:_,dryRun:f}}export{s as codemod};
+//# sourceMappingURL=codemod.js.map

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

@@ -1,43 +1,40 @@
-/**
- * kb_compact — Extractive context compression.
- *
- * Takes a large text and a focus query, then extracts the most relevant
- * sentences/paragraphs using the embedder for similarity scoring.
- * No LLM needed — pure ONNX inference.
- *
- * Use case: compress a 50K-token file read down to the 2K tokens
- * that actually matter for the current task.
- */
-import type { IEmbedder } from '@kb/embeddings';
-export interface CompactOptions {
-    /** The text to compress (at least one of text/path required) */
-    text?: string;
-    /** File path to read server-side — avoids read_file round-trip (at least one of text/path required) */
-    path?: string;
-    /** The focus query — what are we trying to understand? */
-    query: string;
-    /** Target output size in characters (default: 3000) */
-    maxChars?: number;
-    /** Minimum similarity score to include a segment (0-1, default: 0.3) */
-    minScore?: number;
-    /** Segmentation strategy (default: 'paragraph') */
-    segmentation?: 'paragraph' | 'sentence' | 'line';
+import { FileCache } from "./file-cache.js";
+import { IEmbedder } from "@kb/embeddings";
+
+//#region packages/tools/src/compact.d.ts
+interface CompactOptions {
+  /** The text to compress (at least one of text/path required) */
+  text?: string;
+  /** File path to read server-side — avoids read_file round-trip (at least one of text/path required) */
+  path?: string;
+  /** The focus query — what are we trying to understand? */
+  query: string;
+  /** Target output size in characters (default: 3000) */
+  maxChars?: number;
+  /** Minimum similarity score to include a segment (0-1, default: 0.3) */
+  minScore?: number;
+  /** Segmentation strategy (default: 'paragraph') */
+  segmentation?: 'paragraph' | 'sentence' | 'line';
+  /** Optional file cache — use cached content instead of raw readFile */
+  cache?: FileCache;
 }
-export interface CompactResult {
-    /** The compressed text */
-    text: string;
-    /** Original size in chars */
-    originalChars: number;
-    /** Compressed size in chars */
-    compressedChars: number;
-    /** Compression ratio (0-1, lower = more compressed) */
-    ratio: number;
-    /** Number of segments kept / total */
-    segmentsKept: number;
-    segmentsTotal: number;
+interface CompactResult {
+  /** The compressed text */
+  text: string;
+  /** Original size in chars */
+  originalChars: number;
+  /** Compressed size in chars */
+  compressedChars: number;
+  /** Compression ratio (0-1, lower = more compressed) */
+  ratio: number;
+  /** Number of segments kept / total */
+  segmentsKept: number;
+  segmentsTotal: number;
 }
 /**
  * Compress text by extracting segments most relevant to a query.
  */
-export declare function compact(embedder: IEmbedder, options: CompactOptions): Promise<CompactResult>;
+declare function compact(embedder: IEmbedder, options: CompactOptions): Promise<CompactResult>;
+//#endregion
+export { CompactOptions, CompactResult, compact };
 //# sourceMappingURL=compact.d.ts.map

package/packages/tools/dist/compact.js

@@ -1,3 +1,4 @@
-import{readFile as f}from"node:fs/promises";import{cosineSimilarity as b,segment as C}from"./text-utils.js";async function w(c,r){const{query:l,maxChars:a=3e3,minScore:h=.3,segmentation:p="paragraph"}=r;let t;if(r.text)t=r.text;else if(r.path)t=await f(r.path,"utf-8");else throw new Error('Either "text" or "path" must be provided');if(t.length<=a)return{text:t,originalChars:t.length,compressedChars:t.length,ratio:1,segmentsKept:1,segmentsTotal:1};const s=C(t,p);if(s.length===0)return{text:"",originalChars:t.length,compressedChars:0,ratio:0,segmentsKept:0,segmentsTotal:0};const d=await c.embed(l),g=[];for(let e=0;e<s.length;e++){const o=await c.embed(s[e]),u=b(d,o);g.push({text:s[e],score:u,index:e})}const x=g.filter(e=>e.score>=h).sort((e,o)=>o.score-e.score),n=[];let i=0;for(const e of x){if(i+e.text.length>a){i===0&&(n.push({...e,text:e.text.slice(0,a)}),i=a);break}n.push(e),i+=e.text.length+2}n.sort((e,o)=>e.index-o.index);const m=n.map(e=>e.text).join(`
+import{cosineSimilarity as e,segment as t}from"./text-utils.js";import{readFile as n}from"node:fs/promises";async function r(r,i){let{query:a,maxChars:o=3e3,minScore:s=.3,segmentation:c=`paragraph`}=i,l;if(i.text)l=i.text;else if(i.path)l=i.cache?(await i.cache.get(i.path)).content:await n(i.path,`utf-8`);else throw Error(`Either "text" or "path" must be provided`);if(l.length<=o)return{text:l,originalChars:l.length,compressedChars:l.length,ratio:1,segmentsKept:1,segmentsTotal:1};let u=t(l,c);if(u.length===0)return{text:``,originalChars:l.length,compressedChars:0,ratio:0,segmentsKept:0,segmentsTotal:0};let d=await r.embed(a),f=[];for(let t=0;t<u.length;t++){let n=e(d,await r.embed(u[t]));f.push({text:u[t],score:n,index:t})}let p=f.filter(e=>e.score>=s).sort((e,t)=>t.score-e.score),m=[],h=0;for(let e of p){if(h+e.text.length>o){h===0&&(m.push({...e,text:e.text.slice(0,o)}),h=o);break}m.push(e),h+=e.text.length+2}m.sort((e,t)=>e.index-t.index);let g=m.map(e=>e.text).join(`
 
-`);return{text:m,originalChars:t.length,compressedChars:m.length,ratio:m.length/t.length,segmentsKept:n.length,segmentsTotal:s.length}}export{w as compact};
+`);return{text:g,originalChars:l.length,compressedChars:g.length,ratio:g.length/l.length,segmentsKept:m.length,segmentsTotal:u.length}}export{r as compact};
+//# sourceMappingURL=compact.js.map

package/packages/tools/dist/data-transform.d.ts

@@ -1,10 +1,13 @@
-export interface TransformOptions {
-    input: unknown;
-    expression: string;
+//#region packages/tools/src/data-transform.d.ts
+interface TransformOptions {
+  input: unknown;
+  expression: string;
 }
-export interface TransformResult {
-    output: unknown;
-    outputString: string;
+interface TransformResult {
+  output: unknown;
+  outputString: string;
 }
-export declare function dataTransform(options: TransformOptions): TransformResult;
+declare function dataTransform(options: TransformOptions): TransformResult;
+//#endregion
+export { TransformOptions, TransformResult, dataTransform };
 //# sourceMappingURL=data-transform.d.ts.map

package/packages/tools/dist/data-transform.js

@@ -1 +1,2 @@
-function g(t){const{input:o,expression:e}=t,n=typeof o=="string"?JSON.parse(o):o;let r;if(e===".")r=n;else if(e==="keys")r=Object.keys(d(n));else if(e==="values")r=Object.values(d(n));else if(e==="length")r=Array.isArray(n)?n.length:Object.keys(d(n)).length;else if(e==="flatten")r=u(n).flat();else if(e==="unique")r=[...new Set(u(n))];else if(e==="sort")r=[...u(n)].sort();else if(e==="reverse")r=[...u(n)].reverse();else if(e.startsWith("."))r=p(n,e.slice(1));else if(e.startsWith("map(")&&e.endsWith(")")){const s=e.slice(4,-1).trim(),i=s.startsWith(".")?s.slice(1):s;r=u(n).map(a=>p(a,i))}else if(e.startsWith("select(")&&e.endsWith(")"))r=w(u(n),e.slice(7,-1).trim());else if(e.startsWith("group_by(")&&e.endsWith(")")){const s=e.slice(9,-1).trim().replace(/^\./,""),i={};for(const a of u(n)){const f=String(p(a,s)??"null");i[f]||(i[f]=[]),i[f].push(a)}r=i}else if(e.startsWith("pick(")&&e.endsWith(")")){const s=e.slice(5,-1).split(",").map(i=>i.trim().replace(/^\./,"")).filter(Boolean);r=Array.isArray(n)?u(n).map(i=>k(i,s)):k(n,s)}else throw new Error(`Unsupported expression: ${e}. Supported: ., .path.to.field, keys, values, length, flatten, unique, sort, reverse, map(.field), select(.field == | != | > | < | >= | <= "value"), group_by(.field), pick(.a, .b)`);return{output:r,outputString:typeof r=="string"?r:JSON.stringify(r,null,2)??"null"}}function w(t,o){const e=o.match(/^\.?([\w.[\]]+)\s*(==|!=|>=|<=|>|<)\s*"?([^"]*)"?$/);if(!e)throw new Error(`Unsupported select expression: ${o}`);const[,n,r,s]=e;return t.filter(i=>{const a=p(i,n),f=String(a);switch(r){case"==":return f===s;case"!=":return f!==s;case">":case"<":case">=":case"<=":{const l=Number(a),c=Number(s);return Number.isNaN(l)||Number.isNaN(c)?!1:r===">"?l>c:r==="<"?l<c:r===">="?l>=c:l<=c}default:return!1}})}function k(t,o){const e={};for(const n of o)e[n]=p(t,n);return e}function p(t,o){if(!o)return t;const e=[...o.matchAll(/([^.[\]]+)|\[(\d+)\]/g)].map(r=>r[1]??Number.parseInt(r[2],10));let n=t;for(const r of e){if(n==null)return;if(typeof r=="number"){if(!Array.isArray(n))return;n=n[r];continue}if(typeof n!="object")return;n=n[r]}return n}function u(t){if(!Array.isArray(t))throw new Error("Operation requires an array input.");return t}function d(t){if(!t||typeof t!="object"||Array.isArray(t))throw new Error("Operation requires an object input.");return t}export{g as dataTransform};
+function e(e){let{input:o,expression:s}=e,c;if(typeof o==`string`)try{c=JSON.parse(o)}catch{throw Error(`Invalid JSON input`)}else c=o;let l;if(s===`.`)l=c;else if(s===`keys`)l=Object.keys(a(c));else if(s===`values`)l=Object.values(a(c));else if(s===`length`)l=Array.isArray(c)?c.length:Object.keys(a(c)).length;else if(s===`flatten`)l=i(c).flat();else if(s===`unique`)l=[...new Set(i(c))];else if(s===`sort`)l=[...i(c)].sort();else if(s===`reverse`)l=[...i(c)].reverse();else if(s.startsWith(`.`))l=r(c,s.slice(1));else if(s.startsWith(`map(`)&&s.endsWith(`)`)){let e=s.slice(4,-1).trim(),t=e.startsWith(`.`)?e.slice(1):e;l=i(c).map(e=>r(e,t))}else if(s.startsWith(`select(`)&&s.endsWith(`)`))l=t(i(c),s.slice(7,-1).trim());else if(s.startsWith(`group_by(`)&&s.endsWith(`)`)){let e=s.slice(9,-1).trim().replace(/^\./,``),t={};for(let n of i(c)){let i=String(r(n,e)??`null`);t[i]||(t[i]=[]),t[i].push(n)}l=t}else if(s.startsWith(`pick(`)&&s.endsWith(`)`)){let e=s.slice(5,-1).split(`,`).map(e=>e.trim().replace(/^\./,``)).filter(Boolean);l=Array.isArray(c)?i(c).map(t=>n(t,e)):n(c,e)}else throw Error(`Unsupported expression: ${s}. Supported: ., .path.to.field, keys, values, length, flatten, unique, sort, reverse, map(.field), select(.field == | != | > | < | >= | <= "value"), group_by(.field), pick(.a, .b)`);return{output:l,outputString:typeof l==`string`?l:JSON.stringify(l,null,2)??`null`}}function t(e,t){let n=t.match(/^\.?([\w.[\]]+)\s*(==|!=|>=|<=|>|<)\s*"?([^"]*)"?$/);if(!n)throw Error(`Unsupported select expression: ${t}`);let[,i,a,o]=n;return e.filter(e=>{let t=r(e,i),n=String(t);switch(a){case`==`:return n===o;case`!=`:return n!==o;case`>`:case`<`:case`>=`:case`<=`:{let e=Number(t),n=Number(o);return Number.isNaN(e)||Number.isNaN(n)?!1:a===`>`?e>n:a===`<`?e<n:a===`>=`?e>=n:e<=n}default:return!1}})}function n(e,t){let n={};for(let i of t)n[i]=r(e,i);return n}function r(e,t){if(!t)return e;let n=[...t.matchAll(/([^.[\]]+)|\[(\d+)\]/g)].map(e=>e[1]??Number.parseInt(e[2],10)),r=e;for(let e of n){if(r==null)return;if(typeof e==`number`){if(!Array.isArray(r))return;r=r[e];continue}if(typeof r!=`object`)return;r=r[e]}return r}function i(e){if(!Array.isArray(e))throw Error(`Operation requires an array input.`);return e}function a(e){if(!e||typeof e!=`object`||Array.isArray(e))throw Error(`Operation requires an object input.`);return e}export{e as dataTransform};
+//# sourceMappingURL=data-transform.js.map

package/packages/tools/dist/dead-symbols.d.ts

@@ -1,29 +1,33 @@
-import type { IEmbedder } from '@kb/embeddings';
-import type { IKnowledgeStore } from '@kb/store';
-export interface DeadSymbolOptions {
-    /** Root path to scope the search */
-    rootPath?: string;
-    /** Max symbols to scan (default: 100) */
-    limit?: number;
+import { IEmbedder } from "@kb/embeddings";
+import { IKnowledgeStore } from "@kb/store";
+
+//#region packages/tools/src/dead-symbols.d.ts
+interface DeadSymbolOptions {
+  /** Root path to scope the search */
+  rootPath?: string;
+  /** Max symbols to scan (default: 100) */
+  limit?: number;
 }
-export interface DeadSymbol {
-    name: string;
-    path: string;
-    line: number;
-    kind: string;
+interface DeadSymbol {
+  name: string;
+  path: string;
+  line: number;
+  kind: string;
 }
-export interface DeadSymbolResult {
-    /** Dead symbols in source files (.ts/.js/.tsx/.jsx) — actionable */
-    deadInSource: DeadSymbol[];
-    /** Dead symbols in documentation files (.md) — informational */
-    deadInDocs: DeadSymbol[];
-    totalExports: number;
-    totalDeadSource: number;
-    totalDeadDocs: number;
-    /** @deprecated Use deadInSource instead */
-    deadSymbols: DeadSymbol[];
-    /** @deprecated Use totalDeadSource + totalDeadDocs instead */
-    totalDead: number;
+interface DeadSymbolResult {
+  /** Dead symbols in source files (.ts/.js/.tsx/.jsx) — actionable */
+  deadInSource: DeadSymbol[];
+  /** Dead symbols in documentation files (.md) — informational */
+  deadInDocs: DeadSymbol[];
+  totalExports: number;
+  totalDeadSource: number;
+  totalDeadDocs: number;
+  /** @deprecated Use deadInSource instead */
+  deadSymbols: DeadSymbol[];
+  /** @deprecated Use totalDeadSource + totalDeadDocs instead */
+  totalDead: number;
 }
-export declare function findDeadSymbols(embedder: IEmbedder, store: IKnowledgeStore, options?: DeadSymbolOptions): Promise<DeadSymbolResult>;
+declare function findDeadSymbols(embedder: IEmbedder, store: IKnowledgeStore, options?: DeadSymbolOptions): Promise<DeadSymbolResult>;
+//#endregion
+export { DeadSymbol, DeadSymbolOptions, DeadSymbolResult, findDeadSymbols };
 //# sourceMappingURL=dead-symbols.d.ts.map

package/packages/tools/dist/dead-symbols.js

@@ -1,2 +1,3 @@
-import{extname as I}from"node:path";const P=new Set([".md",".mdx"]);async function k(o,s,c={}){const{rootPath:i,limit:y=100}=c,D=await o.embed("export function class const type interface enum"),g=await s.search(D,{limit:y*3}),h=/^export\s+(?:async\s+)?(?:function|class|const|let|interface|type|enum)\s+(\w+)/gm,b=[];for(const e of g){if(!R(e.record.sourcePath,i))continue;const t=e.record.content;h.lastIndex=0;for(const d of t.matchAll(h)){const l=d.index??0,p=t.slice(0,l).split(`
-`).length-1,u=t.slice(l).match(/export\s+(?:async\s+)?(\w+)/);b.push({name:d[1],path:e.record.sourcePath,line:e.record.startLine+p,kind:u?.[1]??"unknown"})}}const m=new Map;for(const e of b){const t=`${e.path}:${e.name}`;m.has(t)||m.set(t,e)}const S=[];for(const e of m.values()){const t=E(e.name),d=new RegExp(`import\\s+.*\\b${t}\\b.*from`,"m"),l=new RegExp(`export\\s+\\{[^}]*\\b${t}\\b`,"m"),p=await s.ftsSearch(`import ${e.name}`,{limit:10}),u=p.some(a=>a.record.sourcePath!==e.path&&d.test(a.record.content)),w=p.some(a=>a.record.sourcePath!==e.path&&l.test(a.record.content));!u&&!w&&S.push(e)}const f=(e,t)=>e.path===t.path?e.line-t.line:e.path.localeCompare(t.path),n=[],r=[];for(const e of S){const t=I(e.path).toLowerCase();P.has(t)?r.push(e):n.push(e)}return n.sort(f),r.sort(f),{deadInSource:n,deadInDocs:r,totalExports:m.size,totalDeadSource:n.length,totalDeadDocs:r.length,deadSymbols:[...n,...r],totalDead:n.length+r.length}}function E(o){return o.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function R(o,s){if(!s)return!0;const c=x(s).replace(/\/+$/,""),i=x(o);return i===c||i.startsWith(`${c}/`)}function x(o){return o.replace(/\\/g,"/").replace(/^\.\//,"")}export{k as findDeadSymbols};
+import{extname as e}from"node:path";const t=new Set([`.md`,`.mdx`]);async function n(n,a,o={}){let{rootPath:s,limit:c=100}=o,l=await n.embed(`export function class const type interface enum`),u=await a.search(l,{limit:c*3}),d=/^export\s+(?:async\s+)?(?:function|class|const|let|interface|type|enum)\s+(\w+)/gm,f=[];for(let e of u){if(!i(e.record.sourcePath,s))continue;let t=e.record.content;d.lastIndex=0;for(let n of t.matchAll(d)){let r=n.index??0,i=t.slice(0,r).split(`
+`).length-1,a=t.slice(r).match(/export\s+(?:async\s+)?(\w+)/);f.push({name:n[1],path:e.record.sourcePath,line:e.record.startLine+i,kind:a?.[1]??`unknown`})}}let p=new Map;for(let e of f){let t=`${e.path}:${e.name}`;p.has(t)||p.set(t,e)}let m=[];for(let e of p.values()){let t=r(e.name),n=RegExp(`import\\s+.*\\b${t}\\b.*from`,`m`),i=RegExp(`export\\s+\\{[^}]*\\b${t}\\b`,`m`),o=await a.ftsSearch(`import ${e.name}`,{limit:10}),s=o.some(t=>t.record.sourcePath!==e.path&&n.test(t.record.content)),c=o.some(t=>t.record.sourcePath!==e.path&&i.test(t.record.content));!s&&!c&&m.push(e)}let h=(e,t)=>e.path===t.path?e.line-t.line:e.path.localeCompare(t.path),g=[],_=[];for(let n of m){let r=e(n.path).toLowerCase();t.has(r)?_.push(n):g.push(n)}return g.sort(h),_.sort(h),{deadInSource:g,deadInDocs:_,totalExports:p.size,totalDeadSource:g.length,totalDeadDocs:_.length,deadSymbols:[...g,..._],totalDead:g.length+_.length}}function r(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function i(e,t){if(!t)return!0;let n=a(t).replace(/\/+$/,``),r=a(e);return r===n||r.startsWith(`${n}/`)}function a(e){return e.replace(/\\/g,`/`).replace(/^\.\//,``)}export{n as findDeadSymbols};
+//# sourceMappingURL=dead-symbols.js.map

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

@@ -1,34 +1,37 @@
-export interface DelegateOptions {
-    /** The prompt / task to send to the local model. */
-    prompt: string;
-    /** Model to use (default: the first available model). */
-    model?: string;
-    /** Optional system prompt. */
-    system?: string;
-    /** Optional context to include before the prompt. */
-    context?: string;
-    /** Temperature (0-2, default: 0.3 for deterministic-ish output). */
-    temperature?: number;
-    /** Timeout in milliseconds (default: 120_000). */
-    timeout?: number;
-    /** Ollama base URL (default: http://localhost:11434). */
-    baseUrl?: string;
+//#region packages/tools/src/delegate.d.ts
+interface DelegateOptions {
+  /** The prompt / task to send to the local model. */
+  prompt: string;
+  /** Model to use (default: the first available model). */
+  model?: string;
+  /** Optional system prompt. */
+  system?: string;
+  /** Optional context to include before the prompt. */
+  context?: string;
+  /** Temperature (0-2, default: 0.3 for deterministic-ish output). */
+  temperature?: number;
+  /** Timeout in milliseconds (default: 120_000). */
+  timeout?: number;
+  /** Ollama base URL (default: http://localhost:11434). */
+  baseUrl?: string;
 }
-export interface DelegateResult {
-    model: string;
-    response: string;
-    durationMs: number;
-    tokenCount?: number;
-    error?: string;
+interface DelegateResult {
+  model: string;
+  response: string;
+  durationMs: number;
+  tokenCount?: number;
+  error?: string;
 }
 /**
  * Check if Ollama is running and return available models.
  */
-export declare function delegateListModels(baseUrl?: string): Promise<string[]>;
+declare function delegateListModels(baseUrl?: string): Promise<string[]>;
 /**
  * Delegate a task to a local Ollama model.
  *
  * Fails fast if Ollama is not running or no models are available.
  */
-export declare function delegate(options: DelegateOptions): Promise<DelegateResult>;
+declare function delegate(options: DelegateOptions): Promise<DelegateResult>;
+//#endregion
+export { DelegateOptions, DelegateResult, delegate, delegateListModels };
 //# sourceMappingURL=delegate.d.ts.map

package/packages/tools/dist/delegate.js

@@ -1,5 +1,2 @@
-import{request as l}from"node:http";const c="http://localhost:11434",p=12e4;async function d(e=c){const o=await g(`${e}/api/tags`);return(JSON.parse(o).models??[]).map(r=>r.name)}async function w(e){const o=e.baseUrl??c,a=e.timeout??p;let r;try{r=await d(o)}catch{return{model:e.model??"unknown",response:"",durationMs:0,error:`Ollama is not running at ${o}. Start it with: ollama serve`}}if(r.length===0)return{model:"none",response:"",durationMs:0,error:"No Ollama models available. Pull one with: ollama pull qwen2.5-coder:7b"};const t=e.model??r[0];if(!r.includes(t))return{model:t,response:"",durationMs:0,error:`Model "${t}" not found. Available: ${r.join(", ")}`};let s="";e.context&&(s+=`<context>
-${e.context}
-</context>
-
-`),s+=e.prompt;const n=Date.now(),u=JSON.stringify({model:t,prompt:s,system:e.system,stream:!1,options:{temperature:e.temperature??.3}});try{const i=await f(`${o}/api/generate`,u,a),m=JSON.parse(i);return m.error?{model:t,response:"",durationMs:Date.now()-n,error:m.error}:{model:t,response:(m.response??"").trim(),durationMs:Date.now()-n,tokenCount:m.eval_count}}catch(i){return{model:t,response:"",durationMs:Date.now()-n,error:i instanceof Error?i.message:String(i)}}}function g(e){return new Promise((o,a)=>{const r=new URL(e),t=l({hostname:r.hostname,port:r.port,path:r.pathname,method:"GET",timeout:5e3},s=>{const n=[];s.on("data",u=>n.push(u)),s.on("end",()=>o(Buffer.concat(n).toString("utf-8")))});t.on("error",a),t.on("timeout",()=>{t.destroy(),a(new Error("Connection timeout"))}),t.end()})}function f(e,o,a){return new Promise((r,t)=>{const s=new URL(e),n=l({hostname:s.hostname,port:s.port,path:s.pathname,method:"POST",headers:{"Content-Type":"application/json","Content-Length":Buffer.byteLength(o)},timeout:a},u=>{const i=[];u.on("data",m=>i.push(m)),u.on("end",()=>r(Buffer.concat(i).toString("utf-8")))});n.on("error",t),n.on("timeout",()=>{n.destroy(),t(new Error(`Ollama request timed out after ${a}ms`))}),n.write(o),n.end()})}export{w as delegate,d as delegateListModels};
+import{request as e}from"node:http";const t=`http://localhost:11434`;async function n(e=t){let n=await i(`${e}/api/tags`),r;try{r=JSON.parse(n)}catch{throw Error(`Ollama returned invalid JSON`)}return(r.models??[]).map(e=>e.name)}async function r(e){let r=e.baseUrl??t,i=e.timeout??12e4,o;try{o=await n(r)}catch{return{model:e.model??`unknown`,response:``,durationMs:0,error:`Ollama is not running at ${r}. Start it with: ollama serve`}}if(o.length===0)return{model:`none`,response:``,durationMs:0,error:`No Ollama models available. Pull one with: ollama pull qwen2.5-coder:7b`};let s=e.model??o[0];if(!o.includes(s))return{model:s,response:``,durationMs:0,error:`Model "${s}" not found. Available: ${o.join(`, `)}`};let c=``;e.context&&(c+=`<context>\n${e.context}\n</context>\n\n`),c+=e.prompt;let l=Date.now(),u=JSON.stringify({model:s,prompt:c,system:e.system,stream:!1,options:{temperature:e.temperature??.3}});try{let e=await a(`${r}/api/generate`,u,i),t=JSON.parse(e);return t.error?{model:s,response:``,durationMs:Date.now()-l,error:t.error}:{model:s,response:(t.response??``).trim(),durationMs:Date.now()-l,tokenCount:t.eval_count}}catch(e){return{model:s,response:``,durationMs:Date.now()-l,error:e instanceof Error?e.message:String(e)}}}function i(t){return new Promise((n,r)=>{let i=new URL(t),a=e({hostname:i.hostname,port:i.port,path:i.pathname,method:`GET`,timeout:5e3},e=>{let t=[];e.on(`data`,e=>t.push(e)),e.on(`end`,()=>n(Buffer.concat(t).toString(`utf-8`)))});a.on(`error`,r),a.on(`timeout`,()=>{a.destroy(),r(Error(`Connection timeout`))}),a.end()})}function a(t,n,r){return new Promise((i,a)=>{let o=new URL(t),s=e({hostname:o.hostname,port:o.port,path:o.pathname,method:`POST`,headers:{"Content-Type":`application/json`,"Content-Length":Buffer.byteLength(n)},timeout:r},e=>{let t=[];e.on(`data`,e=>t.push(e)),e.on(`end`,()=>i(Buffer.concat(t).toString(`utf-8`)))});s.on(`error`,a),s.on(`timeout`,()=>{s.destroy(),a(Error(`Ollama request timed out after ${r}ms`))}),s.write(n),s.end()})}export{r as delegate,n as delegateListModels};
+//# sourceMappingURL=delegate.js.map

package/packages/tools/dist/diff-parse.d.ts

@@ -1,26 +1,29 @@
-export interface DiffFile {
-    path: string;
-    oldPath?: string;
-    status: 'added' | 'modified' | 'deleted' | 'renamed';
-    hunks: DiffHunk[];
-    additions: number;
-    deletions: number;
+//#region packages/tools/src/diff-parse.d.ts
+interface DiffFile {
+  path: string;
+  oldPath?: string;
+  status: 'added' | 'modified' | 'deleted' | 'renamed';
+  hunks: DiffHunk[];
+  additions: number;
+  deletions: number;
 }
-export interface DiffHunk {
-    oldStart: number;
-    oldLines: number;
-    newStart: number;
-    newLines: number;
-    header: string;
-    changes: DiffChange[];
+interface DiffHunk {
+  oldStart: number;
+  oldLines: number;
+  newStart: number;
+  newLines: number;
+  header: string;
+  changes: DiffChange[];
 }
-export interface DiffChange {
-    type: 'add' | 'delete' | 'context';
-    line: number;
-    content: string;
+interface DiffChange {
+  type: 'add' | 'delete' | 'context';
+  line: number;
+  content: string;
 }
-export interface DiffParseOptions {
-    diff: string;
+interface DiffParseOptions {
+  diff: string;
 }
-export declare function diffParse(options: DiffParseOptions): DiffFile[];
+declare function diffParse(options: DiffParseOptions): DiffFile[];
+//#endregion
+export { DiffChange, DiffFile, DiffHunk, DiffParseOptions, diffParse };
 //# sourceMappingURL=diff-parse.d.ts.map