@vpxa/aikit 0.1.59 → 0.1.60

package/packages/indexer/dist/incremental-indexer.js

@@ -1 +0,0 @@
-import{generateRecordId as e,hashContent as t}from"./file-hasher.js";import{FilesystemCrawler as n}from"./filesystem-crawler.js";import{extractGraph as r}from"./graph-extractor.js";import{AIKIT_PATHS as i,createLogger as a,detectContentType as o,serializeError as s}from"../../core/dist/index.js";import{availableParallelism as c,loadavg as l}from"node:os";import{createChunkerSync as u}from"../../chunker/dist/index.js";const d=a(`indexer`),f=()=>new Promise(e=>setImmediate(e));async function p(e,t,n,r){let i=0;async function a(){for(;i<e.length;){let n=i++;try{await t(e[n])}catch(t){r?.(e[n],t)}n%10==0&&await f()}}await Promise.all(Array.from({length:Math.min(n,e.length)},()=>a()))}function m(e){let t=c(),n=l()[0]/t;return n>1.5?2:n>1?Math.max(2,Math.floor(e/2)):e}const h=Math.max(2,Math.min(4,Math.floor(c()*.5)));var g=class{crawler;indexing=!1;graphStore;hashCache;get isIndexing(){return this.indexing}constructor(e,t){this.embedder=e,this.store=t,this.crawler=new n}setGraphStore(e){this.graphStore=e}setHashCache(e){this.hashCache=e}async index(e,t){if(this.indexing)throw Error(`Indexing is already in progress`);this.indexing=!0;try{return await this.doIndex(e,t,{})}finally{this.indexing=!1}}async getChangedFiles(e){let t=e.indexing.concurrency??h,n=await this.crawlSources(e),{filesToProcess:r}=await this.planIndexWork(n,t,{});return r.map(e=>e.relativePath)}async indexFiles(e,t,n){if(this.indexing)throw Error(`Indexing is already in progress`);this.indexing=!0;try{return await this.doIndexFiles(e,t,n)}finally{this.indexing=!1}}async doIndex(e,t,n={}){let r=Date.now(),i=e.indexing.concurrency??h;t?.({phase:`crawling`,filesTotal:0,filesProcessed:0,chunksTotal:0,chunksProcessed:0});let a=await this.crawlSources(e),{filesToProcess:o,filesSkipped:s,pathsToRemove:c}=await this.planIndexWork(a,i,{skipHashCheck:n.skipHashCheck}),{filesProcessed:l,chunksCreated:u}=await this.processFiles(a,o,i,t,{graphCleared:n.graphCleared}),d=await this.cleanupRemovedFiles(c,i,o.length,l,u,t);return this.hashCache?.flush(),t?.({phase:`done`,filesTotal:o.length,filesProcessed:l,chunksTotal:u,chunksProcessed:u}),{filesProcessed:l,filesSkipped:s,chunksCreated:u,filesRemoved:d,durationMs:Date.now()-r}}async doIndexFiles(e,t,n){let r=Date.now(),i=e.indexing.concurrency??h,a=new Set(t);if(a.size===0)return{filesProcessed:0,filesSkipped:0,chunksCreated:0,filesRemoved:0,durationMs:Date.now()-r};n?.({phase:`crawling`,filesTotal:0,filesProcessed:0,chunksTotal:0,chunksProcessed:0});let o=await this.crawlSources(e),{filesToProcess:s,filesSkipped:c}=await this.planIndexWork(o,i,{requestedPaths:a}),{filesProcessed:l,chunksCreated:u}=await this.processFiles(o,s,i,n,{});return this.hashCache?.flush(),n?.({phase:`done`,filesTotal:s.length,filesProcessed:l,chunksTotal:u,chunksProcessed:u}),{filesProcessed:l,filesSkipped:c,chunksCreated:u,filesRemoved:0,durationMs:Date.now()-r}}async crawlSources(e){return(await Promise.all(e.sources.map(e=>this.crawler.crawl({rootDir:e.path,excludePatterns:e.excludePatterns})))).flat()}async planIndexWork(e,n,r){let i=r.requestedPaths,a=i?e.filter(e=>i.has(e.relativePath)):e;if(r.skipHashCheck)return{filesToProcess:a,filesSkipped:0,pathsToRemove:[]};let o=i?[]:await this.getPathsToRemove(e),c=0,l=[];return await p(a,async e=>{let n=t(e.content);if(this.hashCache){if(this.hashCache.get(e.relativePath)===n){c++;return}}else{let t=await this.store.getBySourcePath(e.relativePath);if(t.length>0&&t[0].fileHash===n){c++;return}}l.push(e)},m(n),(e,t)=>d.error(`Hash check failed`,{sourcePath:e.relativePath,...s(t)})),{filesToProcess:l,filesSkipped:c,pathsToRemove:o}}async getPathsToRemove(e){let t=await this.store.listSourcePaths(),n=new Set(e.map(e=>e.relativePath));return t.filter(e=>!n.has(e)&&!e.startsWith(`${i.aiCurated}/`))}async buildWorkspacePackageMap(e){let t=new Map;for(let n of e)if(n.relativePath.endsWith(`package.json`))try{let e=JSON.parse(n.content);if(typeof e.name!=`string`||e.name.length===0)continue;let r=n.relativePath===`package.json`?``:n.relativePath.replace(/\/package\.json$/,``),i=``;if(typeof e.exports==`string`)i=e.exports;else if(e.exports&&typeof e.exports==`object`){let t=e.exports,n=t[`.`]??t;if(typeof n==`string`)i=n;else if(n&&typeof n==`object`){let e=n,t=e.import??e.module??e.default??e.require;typeof t==`string`&&(i=t)}}!i&&typeof e.module==`string`&&(i=e.module),!i&&typeof e.main==`string`&&(i=e.main);let a=i.replace(/^\.\//,``).replace(/^dist\//,`src/`).replace(/\.(ts|js|mjs|cjs|tsx|jsx)$/,``),o=a?r?`${r}/${a}`:a:r?`${r}/src/index`:`src/index`;t.set(e.name,o)}catch{}return t}async processFiles(n,i,a,c,l={}){let f=0,h=0,g=i.length,_=this.graphStore?await this.buildWorkspacePackageMap(n):void 0,v=[],y=[],b=0,x=[],S=[],C=new Map,w=0,T=async()=>{if(x.length===0)return;let e=x,t=S,n=C;x=[],S=[],C=new Map,w=0,await this.store.upsert(e,t);for(let[e,t]of n)this.hashCache?.set(e,t)},E=async()=>{if(this.graphStore){try{v.length>0&&await this.graphStore.upsertNodes(v),y.length>0&&await this.graphStore.upsertEdges(y)}catch(e){d.warn(`Graph batch flush failed`,s(e))}v=[],y=[],b=0}};return await p(i,async n=>{c?.({phase:`chunking`,filesTotal:g,filesProcessed:f,chunksTotal:h,chunksProcessed:h,currentFile:n.relativePath});let i=o(n.relativePath),a=u(n.extension).chunk(n.content,{sourcePath:n.relativePath,contentType:i});if(a.length===0)return;c?.({phase:`embedding`,filesTotal:g,filesProcessed:f,chunksTotal:h+a.length,chunksProcessed:h,currentFile:n.relativePath});let p=await this.embedder.embedBatch(a.map(e=>e.text)),m=t(n.content),D=a.map((t,r)=>({id:e(n.relativePath,r),content:t.text,sourcePath:t.sourcePath,contentType:t.contentType,headingPath:t.headingPath,chunkIndex:t.chunkIndex,totalChunks:t.totalChunks,startLine:t.startLine,endLine:t.endLine,fileHash:m,indexedAt:new Date().toISOString(),origin:`indexed`,tags:[],version:1}));if(c?.({phase:`storing`,filesTotal:g,filesProcessed:f,chunksTotal:h+a.length,chunksProcessed:h,currentFile:n.relativePath}),x.push(...D),S.push(...p),C.set(n.relativePath,m),w++,w>=20&&await T(),this.graphStore)try{l.graphCleared||await this.graphStore.deleteBySourcePath(n.relativePath);let e=r(n.content,n.relativePath,{workspacePackages:_});e.nodes.length>0&&v.push(...e.nodes),e.edges.length>0&&y.push(...e.edges),b++,b>=50&&await E()}catch(e){d.warn(`Graph extraction failed`,{sourcePath:n.relativePath,...s(e)})}f++,h+=a.length},m(a),(e,t)=>d.error(`Processing failed`,{sourcePath:e.relativePath,...s(t)})),await T(),await E(),{filesProcessed:f,chunksCreated:h}}async cleanupRemovedFiles(e,t,n,r,i,a){if(e.length===0)return 0;let o=0;return a?.({phase:`cleanup`,filesTotal:n,filesProcessed:r,chunksTotal:i,chunksProcessed:i}),await p(e,async e=>{await this.store.deleteBySourcePath(e),this.hashCache?.delete(e),this.graphStore&&await this.graphStore.deleteBySourcePath(e).catch(t=>d.warn(`Graph cleanup failed`,{sourcePath:e,...s(t)})),o++},m(t),(e,t)=>d.error(`Cleanup failed`,{sourcePath:e,...s(t)})),o}async reindexAll(e,t){if(this.indexing)throw Error(`Indexing is already in progress`);this.indexing=!0;try{if(await this.store.dropTable(),this.graphStore)try{let e=await this.graphStore.getStats();e.nodeCount>0&&(await this.graphStore.clear(),d.info(`Graph store cleared`,{nodeCount:e.nodeCount,edgeCount:e.edgeCount}))}catch(e){d.warn(`Graph store clear failed`,s(e))}return await this.doReindex(e,t)}catch(e){throw this.indexing=!1,e}}async doReindex(e,t){try{return await this.doIndex(e,t,{skipHashCheck:!0,graphCleared:!0})}finally{this.indexing=!1}}async getStats(){return this.store.getStats()}};export{g as IncrementalIndexer};

package/packages/indexer/dist/smart-index-scheduler.d.ts

@@ -1,47 +0,0 @@
-import { IncrementalIndexer } from "./incremental-indexer.js";
-import { KBConfig } from "../../core/dist/index.js";
-
-//#region packages/indexer/src/smart-index-scheduler.d.ts
-/**
- * SmartIndexScheduler trickles indexing work over time instead of running
- * large idle-triggered indexing passes.
- */
-declare class SmartIndexScheduler {
-  private readonly indexer;
-  private readonly config;
-  private readonly store?;
-  private trickleTimer;
-  private readonly trickleIntervalMs;
-  private readonly batchSize;
-  private readonly priorityQueue;
-  private changedFiles;
-  private lastRefreshTime;
-  private refreshing;
-  constructor(indexer: IncrementalIndexer, config: KBConfig, store?: {
-    createFtsIndex: () => Promise<void>;
-  } | undefined);
-  /** Start the trickle indexing loop. */
-  start(): void;
-  /** Stop the scheduler and clear all timers. */
-  stop(): void;
-  /**
-   * Add file paths to the front of the priority queue for near-term indexing.
-   */
-  prioritize(...paths: string[]): void;
-  getState(): {
-    mode: 'smart';
-    queueSize: number;
-    changedFilesSize: number;
-    intervalMs: number;
-    batchSize: number;
-    running: boolean;
-  };
-  private readPositiveIntEnv;
-  private scheduleTick;
-  private tick;
-  private getCpuCount;
-  private pickFiles;
-  private maybeRefreshChangedFiles;
-}
-//#endregion
-export { SmartIndexScheduler };

package/packages/indexer/dist/smart-index-scheduler.js

@@ -1 +0,0 @@
-import{statSync as e}from"node:fs";import{createLogger as t}from"../../core/dist/index.js";import{availableParallelism as n,loadavg as r}from"node:os";const i=t(`smart-index`),a=1.5;var o=class{trickleTimer=null;trickleIntervalMs;batchSize;priorityQueue=[];changedFiles=[];lastRefreshTime=0;refreshing=!1;constructor(e,t,n){this.indexer=e,this.config=t,this.store=n,this.trickleIntervalMs=t.indexing.trickleIntervalMs??this.readPositiveIntEnv(`AIKIT_SMART_TRICKLE_MS`,3e4),this.batchSize=t.indexing.trickleBatchSize??this.readPositiveIntEnv(`AIKIT_SMART_BATCH_SIZE`,1)}start(){this.stop(),i.info(`Smart index scheduler started (trickle mode)`,{intervalMs:this.trickleIntervalMs,batchSize:this.batchSize}),this.scheduleTick()}stop(){this.trickleTimer&&=(clearTimeout(this.trickleTimer),null)}prioritize(...t){let n=[...new Set(t.filter(Boolean))].filter(t=>{try{return!e(t).isDirectory()}catch{return console.debug(`smart-index: skipping non-existent path: ${t}`),!1}});for(let e of n){let t=this.priorityQueue.indexOf(e);t>=0&&this.priorityQueue.splice(t,1)}for(let e of n.reverse())this.priorityQueue.unshift(e);this.priorityQueue.length>500&&(this.priorityQueue.length=500),n.length>0&&i.info(`Files prioritized for trickle indexing`,{added:n.length,queued:this.priorityQueue.length})}getState(){return{mode:`smart`,queueSize:this.priorityQueue.length,changedFilesSize:this.changedFiles.length,intervalMs:this.trickleIntervalMs,batchSize:this.batchSize,running:this.trickleTimer!==null}}readPositiveIntEnv(e,t){let n=Number(process.env[e]);return Number.isFinite(n)&&n>0?n:t}scheduleTick(){this.trickleTimer=setTimeout(()=>void this.tick(),this.trickleIntervalMs),this.trickleTimer.unref&&this.trickleTimer.unref()}async tick(){try{if(this.indexer.isIndexing){i.info(`Skipping trickle tick — indexing already in progress`);return}let e=this.getCpuCount(),t=r()[0];if(e>0&&t/e>a){i.info(`Skipping trickle tick — system load too high`,{load:t.toFixed(2),cpuCount:e,threshold:a});return}let n=await this.pickFiles();if(n.length===0){await this.maybeRefreshChangedFiles();return}i.info(`Trickle indexing tick started`,{count:n.length,files:n});let o=await this.indexer.indexFiles(this.config,n);if(this.store)try{await this.store.createFtsIndex()}catch(e){i.warn(`FTS index rebuild failed after trickle tick`,{error:String(e)})}this.changedFiles=this.changedFiles.filter(e=>!n.includes(e)),i.info(`Trickle indexing tick complete`,{filesProcessed:o.filesProcessed,filesSkipped:o.filesSkipped,chunksCreated:o.chunksCreated})}catch(e){i.error(`Trickle indexing tick failed`,{error:String(e)})}finally{this.scheduleTick()}}getCpuCount(){try{return typeof n==`function`?n():4}catch{return 4}}async pickFiles(){let e=[];for(;e.length<this.batchSize&&this.priorityQueue.length>0;){let t=this.priorityQueue.shift();t&&!e.includes(t)&&e.push(t)}if(e.length<this.batchSize)for(await this.maybeRefreshChangedFiles();e.length<this.batchSize&&this.changedFiles.length>0;){let t=this.changedFiles.shift();t&&!e.includes(t)&&e.push(t)}return e}async maybeRefreshChangedFiles(){let e=Date.now();if(!(this.refreshing||this.changedFiles.length>0&&e-this.lastRefreshTime<6e5)){this.refreshing=!0;try{this.changedFiles=await this.indexer.getChangedFiles(this.config),this.lastRefreshTime=e,this.changedFiles.length>0&&i.info(`Refreshed changed files for trickle indexing`,{count:this.changedFiles.length})}catch(e){i.error(`Failed to refresh changed files for trickle indexing`,{error:String(e)})}finally{this.refreshing=!1}}}};export{o as SmartIndexScheduler};

package/packages/server/dist/api.d.ts

@@ -1,3 +0,0 @@
-import { loadConfig } from "./config.js";
-import { KnowledgeBaseComponents, createMcpServer, createServer, initializeKnowledgeBase } from "./server.js";
-export { type KnowledgeBaseComponents, createMcpServer, createServer, initializeKnowledgeBase, loadConfig };

package/packages/server/dist/api.js

@@ -1 +0,0 @@
-import{loadConfig as e}from"./config.js";import{createMcpServer as t,createServer as n,initializeKnowledgeBase as r}from"./server.js";export{t as createMcpServer,n as createServer,r as initializeKnowledgeBase,e as loadConfig};

package/packages/server/dist/auto-gc.d.ts

@@ -1,30 +0,0 @@
-//#region packages/server/src/auto-gc.d.ts
-/**
- * P1-13: Self-tuning garbage collection based on p95 latency.
- *
- * Monitors tool call latency via the replay-interceptor's rolling buffer.
- * When p95 exceeds a threshold the system enters "degraded" state and
- * triggers progressive GC actions. A cooldown period prevents over-collection.
- */
-type GcState = 'healthy' | 'warming' | 'degraded';
-interface GcStatus {
-  state: GcState;
-  p95: number;
-  lastGcAt: number | null;
-  gcCount: number;
-  bufferSize: number;
-}
-type GcCallback = () => Promise<void>;
-/**
- * Evaluate the current latency profile and optionally trigger GC.
- *
- * Call this periodically (e.g. every N tool calls) from the replay interceptor.
- * The optional `gcCallback` receives control when a GC cycle is triggered —
- * the caller decides *what* to clean up (pruning stale curated entries,
- * vacuuming SQLite, removing orphaned graph nodes, etc.).
- */
-declare function checkAndMaybeGc(gcCallback?: GcCallback): void;
-/** Return a snapshot of the GC health state for the status tool. */
-declare function getGcStatus(): GcStatus;
-//#endregion
-export { GcCallback, checkAndMaybeGc, getGcStatus };

package/packages/server/dist/auto-gc.js

@@ -1 +0,0 @@
-import{getLatencyBuffer as e}from"./replay-interceptor.js";import{createLogger as t}from"../../core/dist/index.js";const n=t(`auto-gc`);let r=`warming`,i=null,a=0;function o(){let t=[...e()];if(t.length<10)return 0;t.sort((e,t)=>e-t);let n=Math.floor(t.length*.95);return t[Math.min(n,t.length-1)]}function s(e){let t=o();if(t===0){r=`warming`;return}if(t>500){r=`degraded`;let o=Date.now();if(i&&o-i<36e5){n.debug(`GC cooldown active — skipping`,{lastGcAgoMs:o-i});return}i=o,a++,n.warn(`p95 latency exceeds threshold, triggering GC`,{p95:t,cycle:a}),e&&e().catch(e=>n.error(`GC callback failed`,{err:String(e)}))}else t<200&&(r=`healthy`)}function c(){return{state:r,p95:o(),lastGcAt:i,gcCount:a,bufferSize:e().length}}export{s as checkAndMaybeGc,c as getGcStatus};

package/packages/server/dist/background-task.d.ts

@@ -1,47 +0,0 @@
-//#region packages/server/src/background-task.d.ts
-/**
- * Background task scheduler — runs heavy operations without blocking MCP request handling.
- *
- * Instead of worker_threads (which would duplicate ~200 MB+ ONNX models per thread),
- * this scheduler:
- * 1. Queues tasks and runs them sequentially (prevents OOM from parallel heavy ops)
- * 2. Provides `yieldToEventLoop()` that heavy loops can call between iterations to
- *    keep the MCP JSON-RPC transport responsive
- * 3. Tracks running/pending state for status reporting
- *
- * Why not worker_threads?
- * - ONNX WASM model (~200 MB) must be loaded per thread — doubles memory
- * - tree-sitter WASM and sql.js WASM cannot be shared across threads
- * - The existing adaptive-concurrency indexer already parallelises I/O within the main thread
- */
-interface BackgroundTask {
-  name: string;
-  fn: () => Promise<void>;
-}
-/**
- * Yield control to the event loop so pending I/O (MCP transport, timers)
- * can be processed.  Call this inside tight loops that would otherwise
- * starve the event loop (e.g., embedding 500 chunks in a row).
- *
- * Cost: ~1 ms per call on most systems — negligible for batch work when
- * called every 10-50 iterations.
- */
-declare function yieldToEventLoop(): Promise<void>;
-declare class BackgroundTaskScheduler {
-  private readonly queue;
-  private running;
-  /** Whether a task is currently executing. */
-  get isRunning(): boolean;
-  /** Name of the currently running task, or null. */
-  get currentTask(): string | null;
-  /** Number of tasks waiting in the queue. */
-  get pendingCount(): number;
-  /**
-   * Enqueue a task. Returns a Promise that resolves when the task completes
-   * (or rejects if it throws). Tasks run sequentially in FIFO order.
-   */
-  schedule(task: BackgroundTask): Promise<void>;
-  private processQueue;
-}
-//#endregion
-export { BackgroundTask, BackgroundTaskScheduler, yieldToEventLoop };

package/packages/server/dist/background-task.js

@@ -1 +0,0 @@
-import{createLogger as e}from"../../core/dist/index.js";const t=e(`background-task`);function n(){return new Promise(e=>setImmediate(e))}var r=class{queue=[];running=null;get isRunning(){return this.running!==null}get currentTask(){return this.running}get pendingCount(){return this.queue.length}schedule(e){return new Promise((t,n)=>{this.queue.push({...e,resolve:t,reject:n}),this.running||this.processQueue()})}async processQueue(){for(;this.queue.length>0;){let e=this.queue.shift();if(!e)break;this.running=e.name,t.info(`Background task started`,{task:e.name,pending:this.queue.length});let n=Date.now();try{await e.fn();let r=Date.now()-n;t.info(`Background task completed`,{task:e.name,durationMs:r}),e.resolve()}catch(r){let i=Date.now()-n;t.error(`Background task failed`,{task:e.name,durationMs:i,err:r}),e.reject(r instanceof Error?r:Error(String(r)))}}this.running=null}};export{r as BackgroundTaskScheduler,n as yieldToEventLoop};

package/packages/server/dist/completions.d.ts

@@ -1,14 +0,0 @@
-import { CuratedKnowledgeManager } from "./curated-manager.js";
-import { IGraphStore, IKnowledgeStore } from "../../store/dist/index.js";
-
-//#region packages/server/src/completions.d.ts
-/** Clear all completion caches (useful for testing). */
-declare function clearCompletionCache(): void;
-declare function completeCuratedPaths(curated: CuratedKnowledgeManager, partial: string): Promise<string[]>;
-declare function completeFilePaths(store: IKnowledgeStore, partial: string): Promise<string[]>;
-declare function completeSymbolNames(graphStore: IGraphStore, partial: string): Promise<string[]>;
-declare function completeStashKeys(partial: string): string[];
-declare function completeWorksetNames(partial: string): string[];
-declare function completeCheckpointNames(partial: string): string[];
-//#endregion
-export { clearCompletionCache, completeCheckpointNames, completeCuratedPaths, completeFilePaths, completeStashKeys, completeSymbolNames, completeWorksetNames };

package/packages/server/dist/completions.js

@@ -1 +0,0 @@
-import{checkpointList as e,listWorksets as t,stashList as n}from"../../tools/dist/index.js";const r=3e4,i=new Map;function a(e,t,n){let r=i.get(e);if(r&&Date.now()<r.expires)return Promise.resolve(r.data);let a=n();return Promise.resolve(a).then(n=>(i.set(e,{data:n,expires:Date.now()+t}),n))}function o(){i.clear()}function s(e,t){return a(`curated-paths`,r,async()=>(await e.list()).map(e=>e.path)).then(e=>e.filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20))}function c(e,t){return a(`file-paths`,r,()=>e.listSourcePaths()).then(e=>e.filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20))}function l(e,t){return a(`symbol-names`,r,async()=>(await e.findNodes({type:`symbol`,limit:500})).map(e=>e.name)).then(e=>e.filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20))}function u(e){return n().map(e=>e.key).filter(t=>t.toLowerCase().includes(e.toLowerCase())).slice(0,20)}function d(e){return t().map(e=>e.name).filter(t=>t.toLowerCase().includes(e.toLowerCase())).slice(0,20)}function f(t){return e().map(e=>e.label).filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20)}export{o as clearCompletionCache,f as completeCheckpointNames,s as completeCuratedPaths,c as completeFilePaths,u as completeStashKeys,l as completeSymbolNames,d as completeWorksetNames};

package/packages/server/dist/compression-interceptor.d.ts

@@ -1,12 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-
-//#region packages/server/src/compression-interceptor.d.ts
-interface CompressionInterceptorOptions {
-  /** Minimum character count before compression kicks in (default: 4000) */
-  threshold?: number;
-  /** Maximum token budget for compressed output (default: 2000) */
-  tokenBudget?: number;
-}
-declare function installCompressionInterceptor(server: McpServer, options?: CompressionInterceptorOptions): void;
-//#endregion
-export { CompressionInterceptorOptions, installCompressionInterceptor };

package/packages/server/dist/compression-interceptor.js

@@ -1 +0,0 @@
-import{compressTerminalOutput as e}from"../../tools/dist/index.js";const t=new Set([`compact`,`digest`,`file_summary`,`stratum_card`,`present`,`web_fetch`,`web_search`]);function n(n,r){let i=r?.threshold??4e3,a=r?.tokenBudget??2e3,o=n.registerTool.bind(n);n.registerTool=(n,r,s)=>t.has(n)?o(n,r,s):o(n,r,async(t,r)=>{let o=await s(t,r);if(!Array.isArray(o.content))return o;let c=0;for(let e of o.content)e.type===`text`&&typeof e.text==`string`&&(c+=e.text.length);if(c<i)return o;let l=o.content.map(t=>{if(t.type!==`text`||typeof t.text!=`string`||t.text.length<i)return t;let r=e({text:t.text,tool:n,tokenBudget:a});return{...t,text:r.text}});return{...o,content:l}})}export{n as installCompressionInterceptor};

package/packages/server/dist/config.d.ts

@@ -1,16 +0,0 @@
-import { KBConfig } from "../../core/dist/index.js";
-
-//#region packages/server/src/config.d.ts
-type IndexMode = NonNullable<KBConfig['indexMode']>;
-declare function resolveIndexMode(config: KBConfig): IndexMode;
-declare function loadConfig(): KBConfig;
-/**
- * Re-target an existing config to a new workspace root.
- *
- * Called after MCP roots are resolved — the initial config was built with
- * `process.cwd()` (unknown at user-level), so we re-point source paths,
- * store path, and curated path to the actual workspace the IDE has open.
- */
-declare function reconfigureForWorkspace(config: KBConfig, workspaceRoot: string): void;
-//#endregion
-export { loadConfig, reconfigureForWorkspace, resolveIndexMode };

package/packages/server/dist/cross-workspace.d.ts

@@ -1,43 +0,0 @@
-import { RegistryEntry, SearchResult } from "../../core/dist/index.js";
-import { IKnowledgeStore, SearchOptions } from "../../store/dist/index.js";
-
-//#region packages/server/src/cross-workspace.d.ts
-interface CrossWorkspaceOptions {
-  /** Workspace partition names or folder basenames to include. `"*"` means all. */
-  workspaces: string[];
-  /** Current workspace partition (excluded from cross-workspace queries to avoid double results) */
-  currentPartition?: string;
-}
-/**
- * Resolve workspace identifiers to partition entries.
- * Accepts partition keys (exact) or folder basenames (fuzzy match).
- * Special value `"*"` resolves to all registered workspaces.
- */
-declare function resolveWorkspaces(identifiers: string[], currentPartition?: string): RegistryEntry[];
-/**
- * Open temporary read-only store instances for the specified workspace partitions.
- * Caller MUST call closeAll() when done.
- */
-declare function openWorkspaceStores(entries: RegistryEntry[]): Promise<{
-  stores: Map<string, IKnowledgeStore>;
-  closeAll: () => Promise<void>;
-}>;
-/**
- * Fan-out a vector search to multiple workspace stores in parallel.
- * Returns merged results sorted by score descending, with workspace labels.
- */
-declare function fanOutSearch(stores: Map<string, IKnowledgeStore>, queryVector: Float32Array, options: SearchOptions & {
-  limit: number;
-}): Promise<Array<SearchResult & {
-  workspace: string;
-}>>;
-/**
- * Fan-out a full-text search to multiple workspace stores in parallel.
- */
-declare function fanOutFtsSearch(stores: Map<string, IKnowledgeStore>, query: string, options: SearchOptions & {
-  limit: number;
-}): Promise<Array<SearchResult & {
-  workspace: string;
-}>>;
-//#endregion
-export { CrossWorkspaceOptions, fanOutFtsSearch, fanOutSearch, openWorkspaceStores, resolveWorkspaces };

package/packages/server/dist/cross-workspace.js

@@ -1 +0,0 @@
-import{createLogger as e,getPartitionDir as t,isUserInstalled as n,listWorkspaces as r}from"../../core/dist/index.js";import{createStore as i}from"../../store/dist/index.js";const a=e(`cross-workspace`);function o(e,t){if(!n())return[];let i=r();if(i.length===0)return[];if(e.includes(`*`))return t?i.filter(e=>e.partition!==t):i;let a=[];for(let n of e){let e=i.find(e=>e.partition===n);if(e){e.partition!==t&&a.push(e);continue}let r=i.filter(e=>e.partition!==t&&e.partition.replace(/-[a-f0-9]{8}$/,``)===n.toLowerCase());a.push(...r)}let o=new Set;return a.filter(e=>o.has(e.partition)?!1:(o.add(e.partition),!0))}async function s(e){let n=new Map;for(let r of e)try{let e=await i({backend:`lancedb`,path:t(r.partition)});await e.initialize(),n.set(r.partition,e)}catch(e){a.warn(`Failed to open workspace store`,{partition:r.partition,err:e})}return{stores:n,closeAll:async()=>{for(let[,e]of n)try{await e.close()}catch{}}}}async function c(e,t,n){let r=[...e.entries()].map(async([e,r])=>{try{return(await r.search(t,n)).map(t=>({...t,workspace:e}))}catch(t){return a.warn(`Cross-workspace search failed for partition`,{partition:e,err:t}),[]}});return(await Promise.all(r)).flat().sort((e,t)=>t.score-e.score).slice(0,n.limit)}async function l(e,t,n){let r=[...e.entries()].map(async([e,r])=>{try{return(await r.ftsSearch(t,n)).map(t=>({...t,workspace:e}))}catch(t){return a.warn(`Cross-workspace FTS search failed for partition`,{partition:e,err:t}),[]}});return(await Promise.all(r)).flat().sort((e,t)=>t.score-e.score).slice(0,n.limit)}export{l as fanOutFtsSearch,c as fanOutSearch,s as openWorkspaceStores,o as resolveWorkspaces};

package/packages/server/dist/curated-manager.d.ts

@@ -1,92 +0,0 @@
-import { IEmbedder } from "../../embeddings/dist/index.js";
-import { IKnowledgeStore } from "../../store/dist/index.js";
-
-//#region packages/server/src/curated-manager.d.ts
-type CuratedCategory = string;
-interface CuratedEntry {
-  path: string;
-  title: string;
-  category: string;
-  tags: string[];
-  version: number;
-  created: string;
-  updated: string;
-  contentPreview: string;
-}
-interface CuratedFrontmatter {
-  title: string;
-  category: string;
-  tags: string[];
-  created: string;
-  updated: string;
-  version: number;
-  origin: 'curated';
-  changelog: Array<{
-    version: number;
-    date: string;
-    reason: string;
-  }>;
-}
-/**
- * Manages curated knowledge files — the LLM's persistent memory.
- * Files are stored as markdown in a .ai/curated/ directory with YAML frontmatter.
- */
-declare class CuratedKnowledgeManager {
-  private readonly curatedDir;
-  private readonly store;
-  private readonly embedder;
-  constructor(curatedDir: string, store: IKnowledgeStore, embedder: IEmbedder);
-  remember(title: string, content: string, category: CuratedCategory, tags?: string[]): Promise<{
-    path: string;
-  }>;
-  update(relativePath: string, newContent: string, reason: string): Promise<{
-    path: string;
-    version: number;
-  }>;
-  forget(relativePath: string, _reason: string): Promise<{
-    path: string;
-  }>;
-  read(relativePath: string): Promise<CuratedEntry & {
-    content: string;
-  }>;
-  list(filters?: {
-    category?: CuratedCategory;
-    tag?: string;
-  }): Promise<CuratedEntry[]>;
-  /**
-   * Re-index all curated files into the vector store.
-   * Call this after the indexer has run to restore curated vectors
-   * that may have been lost, or to bulk-sync disk state to vectors.
-   */
-  reindexAll(): Promise<{
-    indexed: number;
-    errors: string[];
-  }>;
-  private indexCuratedFile;
-  private discoverCategories;
-  /**
-   * Normalize and validate a relative path within .ai/curated/.
-   * Returns the cleaned path (mutates nothing — caller must use the return value).
-   */
-  private guardPath;
-  private validateCategoryName;
-  private validateContentSize;
-  private slugify;
-  /** Return a unique `category/slug.md` path, appending `-2`, `-3`, … on collision. */
-  private uniqueRelativePath;
-  private hash;
-  private hashId;
-  /**
-   * Simple YAML frontmatter serializer (no gray-matter dependency).
-   */
-  private serializeFile;
-  /**
-   * Simple YAML frontmatter parser (no gray-matter dependency).
-   */
-  parseFile(raw: string): {
-    frontmatter: CuratedFrontmatter;
-    content: string;
-  };
-}
-//#endregion
-export { CuratedCategory, CuratedEntry, CuratedKnowledgeManager };

package/packages/server/dist/curated-manager.js

@@ -1,5 +0,0 @@
-import{dirname as e,isAbsolute as t,join as n}from"node:path";import{createLogger as r,serializeError as i}from"../../core/dist/index.js";import{createHash as a}from"node:crypto";import{mkdir as o,readFile as s,readdir as c,stat as l,unlink as u,writeFile as d}from"node:fs/promises";const f=50*1024,p=r(`server`);var m=class{constructor(e,t,n){this.curatedDir=e,this.store=t,this.embedder=n}async remember(t,r,i,a=[]){this.validateCategoryName(i),this.validateContentSize(r);let s=this.slugify(t),c=await this.uniqueRelativePath(i,s),l=n(this.curatedDir,c),f=new Date().toISOString(),p={title:t,category:i,tags:a,created:f,updated:f,version:1,origin:`curated`,changelog:[{version:1,date:f,reason:`Initial creation`}]},m=this.serializeFile(r,p);await o(e(l),{recursive:!0});try{await d(l,m,{encoding:`utf-8`,flag:`wx`})}catch(e){throw e.code===`EEXIST`?Error(`Concurrent write collision for "${c}" — retry the operation`):e}try{await this.indexCuratedFile(c,r,p)}catch(e){throw await u(l).catch(()=>{}),Error(`Remember failed: wrote file but indexing failed — rolled back. ${e.message}`)}return{path:c}}async update(e,t,r){e=this.guardPath(e),this.validateContentSize(t);let i=n(this.curatedDir,e),a=await s(i,`utf-8`),{frontmatter:o}=this.parseFile(a),c=(o.version??1)+1,l=new Date().toISOString();return o.version=c,o.updated=l,o.changelog=[...o.changelog??[],{version:c,date:l,reason:r}],await d(i,this.serializeFile(t,o),`utf-8`),await this.indexCuratedFile(e,t,o),{path:e,version:c}}async forget(e,t){e=this.guardPath(e),await u(n(this.curatedDir,e));let r=`.ai/curated/${e}`;return await this.store.deleteBySourcePath(r).catch(e=>{p.warn(`File deleted but vector cleanup failed`,{sourcePath:r,...i(e)})}),{path:e}}async read(e){e=this.guardPath(e);let t=await s(n(this.curatedDir,e),`utf-8`),{frontmatter:r,content:i}=this.parseFile(t),a=e.split(`/`)[0];return{path:e,title:r.title??e,category:a,tags:r.tags??[],version:r.version??1,created:r.created??``,updated:r.updated??``,contentPreview:i.slice(0,200),content:i}}async list(e){let t=[],r=e?.category?[e.category]:await this.discoverCategories();for(let i of r){let r=n(this.curatedDir,i);try{let a=await c(r);for(let o of a){if(!o.endsWith(`.md`))continue;let a=await s(n(r,o),`utf-8`),{frontmatter:c,content:l}=this.parseFile(a);e?.tag&&!(c.tags??[]).includes(e.tag)||t.push({path:`${i}/${o}`,title:c.title??o,category:i,tags:c.tags??[],version:c.version??1,created:c.created??``,updated:c.updated??``,contentPreview:l.slice(0,200)})}}catch{}}return t}async reindexAll(){let e=await this.discoverCategories(),t=[],r=[];for(let a of e){let e=n(this.curatedDir,a),o;try{o=(await c(e)).filter(e=>e.endsWith(`.md`))}catch{continue}for(let c of o){let o=`${a}/${c}`,l=n(e,c);try{let e=await s(l,`utf-8`),{frontmatter:t,content:n}=this.parseFile(e);r.push({relativePath:o,content:n,frontmatter:t})}catch(e){p.error(`Failed to read curated file`,{relativePath:o,...i(e)}),t.push(`${o}: read failed`)}}}if(r.length===0)return{indexed:0,errors:t};let a=await this.embedder.embedBatch(r.map(e=>e.content)),o=new Date().toISOString(),l=r.map(e=>{let t=`.ai/curated/${e.relativePath}`;return{id:this.hashId(t,0),content:e.content,sourcePath:t,contentType:`curated-knowledge`,headingPath:e.frontmatter.title,chunkIndex:0,totalChunks:1,startLine:1,endLine:e.content.split(`
-`).length,fileHash:this.hash(e.content),indexedAt:o,origin:`curated`,tags:e.frontmatter.tags,category:e.frontmatter.category,version:e.frontmatter.version}});return await this.store.upsert(l,a),{indexed:r.length,errors:t}}async indexCuratedFile(e,t,n){let r=await this.embedder.embed(t),i=`.ai/curated/${e}`,a=new Date().toISOString(),o={id:this.hashId(i,0),content:t,sourcePath:i,contentType:`curated-knowledge`,headingPath:n.title,chunkIndex:0,totalChunks:1,startLine:1,endLine:t.split(`
-`).length,fileHash:this.hash(t),indexedAt:a,origin:`curated`,tags:n.tags,category:n.category,version:n.version};await this.store.upsert([o],[r])}async discoverCategories(){try{return(await c(this.curatedDir,{withFileTypes:!0})).filter(e=>e.isDirectory()&&/^[a-z][a-z0-9-]*$/.test(e.name)).map(e=>e.name)}catch{return[]}}guardPath(e){let n=e.replace(/^\.ai\/curated\//,``);if(n.endsWith(`.md`)||(n+=`.md`),n.includes(`..`)||t(n))throw Error(`Invalid path: ${n}. Must be relative within .ai/curated/ directory.`);let r=n.split(`/`)[0];return this.validateCategoryName(r),n}validateCategoryName(e){if(!/^[a-z][a-z0-9-]*$/.test(e))throw Error(`Invalid category name: "${e}". Must be lowercase kebab-case (e.g., "decisions", "api-contracts").`)}validateContentSize(e){if(Buffer.byteLength(e,`utf-8`)>f)throw Error(`Content exceeds maximum size of ${f/1024}KB`)}slugify(e){return e.toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-|-$/g,``).slice(0,80)}async uniqueRelativePath(e,t){let r=`${e}/${t}.md`,i=n(this.curatedDir,r);try{await l(i)}catch{return r}for(let r=2;r<=100;r++){let i=`${e}/${t}-${r}.md`;try{await l(n(this.curatedDir,i))}catch{return i}}throw Error(`Too many entries with slug "${t}" in category "${e}"`)}hash(e){return a(`sha256`).update(e).digest(`hex`).slice(0,16)}hashId(e,t){return this.hash(`${e}::${t}`)}serializeFile(e,t){return`${[`---`,`title: "${t.title.replace(/"/g,`\\"`)}"`,`category: ${t.category}`,`tags: [${t.tags.map(e=>`"${e}"`).join(`, `)}]`,`created: ${t.created}`,`updated: ${t.updated}`,`version: ${t.version}`,`origin: ${t.origin}`,`changelog:`,...t.changelog.map(e=>`  - version: ${e.version}\n    date: ${e.date}\n    reason: "${e.reason.replace(/"/g,`\\"`)}"`),`---`].join(`
-`)}\n\n${e}\n`}parseFile(e){let t=e.match(/^---\n([\s\S]*?)\n---\n\n?([\s\S]*)$/);if(!t)return{frontmatter:{title:`Untitled`,category:`notes`,tags:[],created:``,updated:``,version:1,origin:`curated`,changelog:[]},content:e};let n=t[1],r=t[2].trim(),i={},a=[],o=n.split(`
-`),s=!1,c={};for(let e of o){if(/^changelog:\s*$/.test(e)){s=!0;continue}if(s){let t=e.match(/^\s+-\s+version:\s*(\d+)$/);if(t){c.version!=null&&a.push(c),c={version:parseInt(t[1],10)};continue}let n=e.match(/^\s+date:\s*(.+)$/);if(n){c.date=n[1].trim();continue}let r=e.match(/^\s+reason:\s*"?(.*?)"?\s*$/);if(r){c.reason=r[1];continue}/^\w/.test(e)&&(s=!1,c.version!=null&&a.push(c),c={});continue}let t=e.match(/^(\w+):\s*(.*)$/);if(t){let e=t[1],n=t[2];typeof n==`string`&&n.startsWith(`[`)&&n.endsWith(`]`)?n=n.slice(1,-1).split(`,`).map(e=>e.trim().replace(/^"|"$/g,``)).filter(e=>e.length>0):typeof n==`string`&&/^\d+$/.test(n)?n=parseInt(n,10):typeof n==`string`&&n.startsWith(`"`)&&n.endsWith(`"`)&&(n=n.slice(1,-1)),i[e]=n}}return c.version!=null&&a.push(c),{frontmatter:{title:i.title??`Untitled`,category:i.category??`notes`,tags:i.tags??[],created:i.created??``,updated:i.updated??``,version:i.version??1,origin:`curated`,changelog:a},content:r}}};export{m as CuratedKnowledgeManager};

package/packages/server/dist/dashboard-static.d.ts

@@ -1,27 +0,0 @@
-import * as _$express from "express";
-
-//#region packages/server/src/dashboard-static.d.ts
-type DashboardApp = {
-  get: (path: string, handler: (req: _$express.Request, res: _$express.Response) => void) => void;
-};
-type DashboardLogger = {
-  info: (message: string, meta?: Record<string, unknown>) => void;
-};
-type DashboardRequestResolution = {
-  kind: 'file';
-  path: string;
-  contentType: string;
-} | {
-  kind: 'spa';
-  path: string;
-  contentType: 'text/html';
-} | {
-  kind: 'forbidden';
-} | {
-  kind: 'not-found';
-};
-declare function resolveDashboardDir(baseDir?: string): string;
-declare function resolveDashboardRequest(dashboardDir: string, requestPath: string): DashboardRequestResolution;
-declare function registerDashboardRoutes(app: DashboardApp, dashboardDir: string, logger: DashboardLogger): boolean;
-//#endregion
-export { DashboardRequestResolution, registerDashboardRoutes, resolveDashboardDir, resolveDashboardRequest };

package/packages/server/dist/elicitor.d.ts

@@ -1,18 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { Elicitor } from "../../elicitation/dist/index.js";
-
-//#region packages/server/src/elicitor.d.ts
-/**
- * Create an Elicitor backed by the MCP server's elicitInput capability.
- *
- * All methods degrade gracefully: if the client does not support elicitation,
- * they return decline / false / null / [] defaults without throwing.
- */
-declare function createElicitor(mcpServer: McpServer): Elicitor;
-/**
- * No-op Elicitor — always returns decline / false / null / [].
- * Used when no MCP server is available.
- */
-declare const noopElicitor: Elicitor;
-//#endregion
-export { createElicitor, noopElicitor };

package/packages/server/dist/elicitor.js

@@ -1 +0,0 @@
-import{buildFormSchema as e,field as t,normalizeResponse as n}from"../../elicitation/dist/index.js";function r(r){function i(){return!!r.server?.getClientCapabilities?.()?.elicitation}async function a(e,t){if(i())try{let i=await r.server.elicitInput({message:e,requestedSchema:t});return n(i?{action:i.action,content:i.content}:void 0)}catch{return}}return{get available(){return i()},async ask(e){return await a(e.message,e.schema)||{action:`decline`}},async confirm(n){let r=await a(n,e({confirmed:t.confirm(n)}));return r?.action===`accept`&&r.content?.confirmed===!0},async selectOne(n,r){let i=await a(n,e({selection:t.select(`Choose one`,r)}));if(i?.action!==`accept`)return null;let o=i.content?.selection;return typeof o==`string`?o:null},async selectMany(n,r){let i=await a(n,e({selections:t.multi(`Choose one or more`,r)}));if(i?.action!==`accept`)return[];let o=i.content?.selections;return Array.isArray(o)?o:[]},async promptText(n,r){let i=await a(n,e({text:t.text(n,{description:r})}));if(i?.action!==`accept`)return null;let o=i.content?.text;return typeof o==`string`?o:null}}}const i={available:!1,async ask(){return{action:`decline`}},async confirm(){return!1},async selectOne(){return null},async selectMany(){return[]},async promptText(){return null}};export{r as createElicitor,i as noopElicitor};

package/packages/server/dist/idle-timer.d.ts

@@ -1,33 +0,0 @@
-//#region packages/server/src/idle-timer.d.ts
-/**
- * Resource lifecycle manager — tracks tool activity and closes idle resources.
- *
- * When no tool has been invoked for `idleMs`, the manager calls the registered
- * cleanup callbacks.  Resources are re-initialised lazily on next tool call.
- */
-interface IdleTimerOptions {
-  /** Milliseconds of inactivity before cleanup fires.  @default 300_000 */
-  idleMs?: number;
-}
-declare class IdleTimer {
-  private timer;
-  private readonly cleanupFns;
-  private readonly idleMs;
-  private disposed;
-  /** When true, cleanup is suppressed (e.g. during long-running indexing). */
-  private _busy;
-  constructor(opts?: IdleTimerOptions);
-  /** Mark the server as busy (suppresses idle cleanup while true). */
-  setBusy(busy: boolean): void;
-  /** Register a cleanup callback that runs when idle threshold is reached. */
-  onIdle(fn: () => void | Promise<void>): void;
-  /** Call this on every tool invocation to reset the idle countdown. */
-  touch(): void;
-  /** Cancel the pending idle timer without running cleanup. */
-  cancel(): void;
-  /** Stop the timer permanently and release all callbacks. */
-  dispose(): void;
-  private runCleanup;
-}
-//#endregion
-export { IdleTimer, IdleTimerOptions };

package/packages/server/dist/idle-timer.js

@@ -1 +0,0 @@
-import{createLogger as e}from"../../core/dist/index.js";const t=e(`idle-timer`);var n=class{timer=null;cleanupFns=[];idleMs;disposed=!1;_busy=!1;constructor(e){this.idleMs=e?.idleMs??3e5}setBusy(e){this._busy=e,e?this.cancel():this.touch()}onIdle(e){this.cleanupFns.push(e)}touch(){this.disposed||this._busy||(this.cancel(),this.timer=setTimeout(()=>{this.runCleanup()},this.idleMs),this.timer.unref&&this.timer.unref())}cancel(){this.timer&&=(clearTimeout(this.timer),null)}dispose(){this.cancel(),this.cleanupFns.length=0,this.disposed=!0}async runCleanup(){if(this._busy){t.info(`Skipping idle cleanup — background work in progress`);return}t.info(`Idle for ${this.idleMs/1e3}s — running cleanup`);let e=await Promise.allSettled(this.cleanupFns.map(e=>e()));for(let n of e)n.status===`rejected`&&t.warn(`Idle cleanup callback failed`,{error:String(n.reason)})}};export{n as IdleTimer};

package/packages/server/dist/mcp-logging.d.ts

@@ -1,11 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-
-//#region packages/server/src/mcp-logging.d.ts
-/**
- * Bridge internal logger messages to MCP client via `sendLoggingMessage`.
- * Fire-and-forget — never blocks the log caller, never throws.
- * Returns a cleanup function to remove the bridge.
- */
-declare function bridgeMcpLogging(server: McpServer): () => void;
-//#endregion
-export { bridgeMcpLogging };

package/packages/server/dist/mcp-logging.js

@@ -1 +0,0 @@
-import{addLogListener as e}from"../../core/dist/index.js";const t={debug:`debug`,info:`info`,warn:`warning`,error:`error`};function n(n){return e(({level:e,component:r,message:i,data:a})=>{try{Promise.resolve(n.sendLoggingMessage({level:t[e],logger:r,data:a?{message:i,...a}:i})).catch(()=>{})}catch{}})}export{n as bridgeMcpLogging};

package/packages/server/dist/memory-monitor.d.ts

@@ -1,37 +0,0 @@
-//#region packages/server/src/memory-monitor.d.ts
-/**
- * Memory monitor — periodically checks RSS and logs warnings when thresholds are exceeded.
- *
- * Also exposes `getRssBytes()` for on-demand checks and a `onPressure` callback
- * for triggering cache eviction or GC hints when memory is high.
- */
-interface MemoryMonitorOptions {
-  /** RSS bytes above which a warning is logged.  @default 4 GB */
-  warningBytes?: number;
-  /** RSS bytes above which pressure callbacks fire.  @default 8 GB */
-  criticalBytes?: number;
-  /** Polling interval in milliseconds.  @default 60 000 */
-  intervalMs?: number;
-}
-type PressureLevel = 'normal' | 'warning' | 'critical';
-declare class MemoryMonitor {
-  private timer;
-  private readonly warningBytes;
-  private readonly criticalBytes;
-  private readonly intervalMs;
-  private readonly pressureFns;
-  private lastLevel;
-  constructor(opts?: MemoryMonitorOptions);
-  /** Register a callback for memory pressure events. */
-  onPressure(fn: (level: PressureLevel, rssBytes: number) => void): void;
-  /** Start periodic monitoring. */
-  start(): void;
-  /** Stop monitoring. */
-  stop(): void;
-  /** Return current RSS in bytes. */
-  getRssBytes(): number;
-  /** Run a single check. */
-  check(): PressureLevel;
-}
-//#endregion
-export { MemoryMonitor, MemoryMonitorOptions, PressureLevel };

package/packages/server/dist/memory-monitor.js

@@ -1 +0,0 @@
-import{createLogger as e}from"../../core/dist/index.js";const t=e(`memory-monitor`);var n=class{timer=null;warningBytes;criticalBytes;intervalMs;pressureFns=[];lastLevel=`normal`;constructor(e){this.warningBytes=e?.warningBytes??4294967296,this.criticalBytes=e?.criticalBytes??8589934592,this.intervalMs=e?.intervalMs??6e4}onPressure(e){this.pressureFns.push(e)}start(){this.timer||(this.timer=setInterval(()=>this.check(),this.intervalMs),this.timer.unref&&this.timer.unref(),t.info(`Memory monitor started`,{warningMB:Math.round(this.warningBytes/1024/1024),criticalMB:Math.round(this.criticalBytes/1024/1024),intervalSec:Math.round(this.intervalMs/1e3)}))}stop(){this.timer&&=(clearInterval(this.timer),null)}getRssBytes(){return process.memoryUsage.rss()}check(){let e=this.getRssBytes(),n=`normal`;if(e>=this.criticalBytes?n=`critical`:e>=this.warningBytes&&(n=`warning`),n!==this.lastLevel||n===`critical`){let r=Math.round(e/1024/1024);n===`critical`?t.warn(`Memory CRITICAL: ${r}MB RSS — consider restarting the server`):n===`warning`?t.warn(`Memory WARNING: ${r}MB RSS`):this.lastLevel!==`normal`&&t.info(`Memory returned to normal: ${r}MB RSS`),this.lastLevel=n}if(n!==`normal`)for(let t of this.pressureFns)try{t(n,e)}catch{}return n===`critical`&&typeof globalThis.gc==`function`&&globalThis.gc(),n}};export{n as MemoryMonitor};