@vpxa/kb 0.1.13 → 0.1.15

package/packages/core/dist/constants.d.ts

@@ -1,49 +1,52 @@
+//#region packages/core/src/constants.d.ts
 /**
  * Default constants for the Knowledge Base system.
  */
 /** Default chunk sizes by content type */
-export declare const CHUNK_SIZES: {
-    readonly markdown: {
-        readonly max: 1500;
-        readonly min: 100;
-    };
-    readonly code: {
-        readonly max: 2000;
-        readonly min: 50;
-    };
-    readonly config: {
-        readonly max: 3000;
-        readonly min: 50;
-    };
-    readonly default: {
-        readonly max: 1500;
-        readonly min: 100;
-        readonly overlap: 200;
-    };
+declare const CHUNK_SIZES: {
+  readonly markdown: {
+    readonly max: 1500;
+    readonly min: 100;
+  };
+  readonly code: {
+    readonly max: 2000;
+    readonly min: 50;
+  };
+  readonly config: {
+    readonly max: 3000;
+    readonly min: 50;
+  };
+  readonly default: {
+    readonly max: 1500;
+    readonly min: 100;
+    readonly overlap: 200;
+  };
 };
 /** Default embedding config */
-export declare const EMBEDDING_DEFAULTS: {
-    readonly model: "mixedbread-ai/mxbai-embed-large-v1";
-    readonly dimensions: 1024;
+declare const EMBEDDING_DEFAULTS: {
+  readonly model: "mixedbread-ai/mxbai-embed-large-v1";
+  readonly dimensions: 1024;
 };
 /** Default store config */
-export declare const STORE_DEFAULTS: {
-    readonly backend: "lancedb";
-    readonly path: ".kb-data";
-    readonly tableName: "knowledge";
+declare const STORE_DEFAULTS: {
+  readonly backend: "lancedb";
+  readonly path: ".kb-data";
+  readonly tableName: "knowledge";
 };
 /** File size limits */
-export declare const FILE_LIMITS: {
-    readonly maxFileSizeBytes: 1000000;
-    readonly maxCuratedFileSizeBytes: 50000;
+declare const FILE_LIMITS: {
+  readonly maxFileSizeBytes: 1000000;
+  readonly maxCuratedFileSizeBytes: 50000;
 };
 /** Search defaults */
-export declare const SEARCH_DEFAULTS: {
-    readonly maxResults: 10;
-    readonly minScore: 0.25;
+declare const SEARCH_DEFAULTS: {
+  readonly maxResults: 10;
+  readonly minScore: 0.25;
 };
 /** Category validation regex */
-export declare const CATEGORY_PATTERN: RegExp;
+declare const CATEGORY_PATTERN: RegExp;
 /** Default knowledge categories */
-export declare const DEFAULT_CATEGORIES: readonly ["decisions", "patterns", "troubleshooting", "conventions", "architecture"];
+declare const DEFAULT_CATEGORIES: readonly ["decisions", "patterns", "troubleshooting", "conventions", "architecture"];
+//#endregion
+export { CATEGORY_PATTERN, CHUNK_SIZES, DEFAULT_CATEGORIES, EMBEDDING_DEFAULTS, FILE_LIMITS, SEARCH_DEFAULTS, STORE_DEFAULTS };
 //# sourceMappingURL=constants.d.ts.map

package/packages/core/dist/constants.js

@@ -1 +1,2 @@
-const e={markdown:{max:1500,min:100},code:{max:2e3,min:50},config:{max:3e3,min:50},default:{max:1500,min:100,overlap:200}},t={model:"mixedbread-ai/mxbai-embed-large-v1",dimensions:1024},o={backend:"lancedb",path:".kb-data",tableName:"knowledge"},a={maxFileSizeBytes:1e6,maxCuratedFileSizeBytes:5e4},n={maxResults:10,minScore:.25},s=/^[a-z][a-z0-9-]*$/,c=["decisions","patterns","troubleshooting","conventions","architecture"];export{s as CATEGORY_PATTERN,e as CHUNK_SIZES,c as DEFAULT_CATEGORIES,t as EMBEDDING_DEFAULTS,a as FILE_LIMITS,n as SEARCH_DEFAULTS,o as STORE_DEFAULTS};
+const e={markdown:{max:1500,min:100},code:{max:2e3,min:50},config:{max:3e3,min:50},default:{max:1500,min:100,overlap:200}},t={model:`mixedbread-ai/mxbai-embed-large-v1`,dimensions:1024},n={backend:`lancedb`,path:`.kb-data`,tableName:`knowledge`},r={maxFileSizeBytes:1e6,maxCuratedFileSizeBytes:5e4},i={maxResults:10,minScore:.25},a=/^[a-z][a-z0-9-]*$/,o=[`decisions`,`patterns`,`troubleshooting`,`conventions`,`architecture`];export{a as CATEGORY_PATTERN,e as CHUNK_SIZES,o as DEFAULT_CATEGORIES,t as EMBEDDING_DEFAULTS,r as FILE_LIMITS,i as SEARCH_DEFAULTS,n as STORE_DEFAULTS};
+//# sourceMappingURL=constants.js.map

package/packages/core/dist/content-detector.d.ts

@@ -1,13 +1,14 @@
-/**
- * Detects content type from file path and extension.
- */
-import type { ContentType, SourceType } from './types.js';
+import { ContentType, SourceType } from "./types.js";
+
+//#region packages/core/src/content-detector.d.ts
 /**
  * Detect the content type of a file based on its path.
  */
-export declare function detectContentType(filePath: string): ContentType;
+declare function detectContentType(filePath: string): ContentType;
 /** Derive the coarse SourceType from a ContentType. */
-export declare function contentTypeToSourceType(ct: ContentType): SourceType;
+declare function contentTypeToSourceType(ct: ContentType): SourceType;
 /** Get all ContentTypes that belong to a given SourceType. */
-export declare function sourceTypeContentTypes(st: SourceType): ContentType[];
+declare function sourceTypeContentTypes(st: SourceType): ContentType[];
+//#endregion
+export { contentTypeToSourceType, detectContentType, sourceTypeContentTypes };
 //# sourceMappingURL=content-detector.d.ts.map

package/packages/core/dist/content-detector.js

@@ -1 +1,2 @@
-import{basename as r,extname as p}from"node:path";const n={".ts":"code-typescript",".tsx":"code-typescript",".mts":"code-typescript",".cts":"code-typescript",".js":"code-javascript",".jsx":"code-javascript",".mjs":"code-javascript",".cjs":"code-javascript",".py":"code-python",".json":"config-json",".yaml":"config-yaml",".yml":"config-yaml",".toml":"config-toml",".env":"config-env",".md":"markdown",".mdx":"markdown"},i=[/\.test\.[jt]sx?$/,/\.spec\.[jt]sx?$/,/(^|\/)__tests__\//,/(^|\/)test\//,/(^|\/)tests\//,/(^|\/)spec\//,/(^|\/)fixtures\//],d=[/\.stack\.[jt]s$/,/(^|\/)stacks\//,/(^|\/)constructs\//,/cdk\.json$/];function m(e){const t=p(e).toLowerCase(),s=r(e).toLowerCase();return e.includes("curated/")?"curated-knowledge":i.some(o=>o.test(e))?"test-code":d.some(o=>o.test(e))?"cdk-stack":t in n?n[t]:s.startsWith(".env")?"config-env":[".go",".rs",".java",".rb",".php",".sh",".ps1",".sql",".graphql",".proto",".css",".scss",".less",".html",".htm",".vue",".svelte",".astro",".hbs",".ejs",".svg"].includes(t)?"code-other":"unknown"}const c={"code-typescript":"source","code-javascript":"source","code-python":"source","code-other":"source","cdk-stack":"source","test-code":"test",markdown:"documentation",documentation:"documentation","curated-knowledge":"documentation","produced-knowledge":"documentation","config-json":"config","config-yaml":"config","config-toml":"config","config-env":"config",unknown:"source"};function y(e){return c[e]??"source"}function T(e){return Object.entries(c).filter(([,t])=>t===e).map(([t])=>t)}export{y as contentTypeToSourceType,m as detectContentType,T as sourceTypeContentTypes};
+import{basename as e,extname as t}from"node:path";const n={".ts":`code-typescript`,".tsx":`code-typescript`,".mts":`code-typescript`,".cts":`code-typescript`,".js":`code-javascript`,".jsx":`code-javascript`,".mjs":`code-javascript`,".cjs":`code-javascript`,".py":`code-python`,".json":`config-json`,".yaml":`config-yaml`,".yml":`config-yaml`,".toml":`config-toml`,".env":`config-env`,".md":`markdown`,".mdx":`markdown`},r=[/\.test\.[jt]sx?$/,/\.spec\.[jt]sx?$/,/(^|\/)__tests__\//,/(^|\/)test\//,/(^|\/)tests\//,/(^|\/)spec\//,/(^|\/)fixtures\//],i=[/\.stack\.[jt]s$/,/(^|\/)stacks\//,/(^|\/)constructs\//,/cdk\.json$/];function a(a){let o=t(a).toLowerCase(),s=e(a).toLowerCase();return a.includes(`curated/`)?`curated-knowledge`:r.some(e=>e.test(a))?`test-code`:i.some(e=>e.test(a))?`cdk-stack`:o in n?n[o]:s.startsWith(`.env`)?`config-env`:[`.go`,`.rs`,`.java`,`.rb`,`.php`,`.sh`,`.ps1`,`.sql`,`.graphql`,`.proto`,`.css`,`.scss`,`.less`,`.html`,`.htm`,`.vue`,`.svelte`,`.astro`,`.hbs`,`.ejs`,`.svg`].includes(o)?`code-other`:`unknown`}const o={"code-typescript":`source`,"code-javascript":`source`,"code-python":`source`,"code-other":`source`,"cdk-stack":`source`,"test-code":`test`,markdown:`documentation`,documentation:`documentation`,"curated-knowledge":`documentation`,"produced-knowledge":`documentation`,"config-json":`config`,"config-yaml":`config`,"config-toml":`config`,"config-env":`config`,unknown:`source`};function s(e){return o[e]??`source`}function c(e){return Object.entries(o).filter(([,t])=>t===e).map(([e])=>e)}export{s as contentTypeToSourceType,a as detectContentType,c as sourceTypeContentTypes};
+//# sourceMappingURL=content-detector.js.map

package/packages/core/dist/errors.d.ts

@@ -1,18 +1,21 @@
-export declare class KBError extends Error {
-    readonly code: string;
-    readonly cause?: unknown | undefined;
-    constructor(message: string, code: string, cause?: unknown | undefined);
+//#region packages/core/src/errors.d.ts
+declare class KBError extends Error {
+  readonly code: string;
+  readonly cause?: unknown | undefined;
+  constructor(message: string, code: string, cause?: unknown | undefined);
 }
-export declare class EmbeddingError extends KBError {
-    constructor(message: string, cause?: unknown);
+declare class EmbeddingError extends KBError {
+  constructor(message: string, cause?: unknown);
 }
-export declare class StoreError extends KBError {
-    constructor(message: string, cause?: unknown);
+declare class StoreError extends KBError {
+  constructor(message: string, cause?: unknown);
 }
-export declare class IndexError extends KBError {
-    constructor(message: string, cause?: unknown);
+declare class IndexError extends KBError {
+  constructor(message: string, cause?: unknown);
 }
-export declare class ConfigError extends KBError {
-    constructor(message: string, cause?: unknown);
+declare class ConfigError extends KBError {
+  constructor(message: string, cause?: unknown);
 }
+//#endregion
+export { ConfigError, EmbeddingError, IndexError, KBError, StoreError };
 //# sourceMappingURL=errors.d.ts.map

package/packages/core/dist/errors.js

@@ -1 +1,2 @@
-class s extends Error{constructor(r,e,t){super(r);this.code=e;this.cause=t;this.name="KBError"}}class E extends s{constructor(n,r){super(n,"EMBEDDING_ERROR",r),this.name="EmbeddingError"}}class c extends s{constructor(n,r){super(n,"STORE_ERROR",r),this.name="StoreError"}}class u extends s{constructor(n,r){super(n,"INDEX_ERROR",r),this.name="IndexError"}}class i extends s{constructor(n,r){super(n,"CONFIG_ERROR",r),this.name="ConfigError"}}export{i as ConfigError,E as EmbeddingError,u as IndexError,s as KBError,c as StoreError};
+var e=class extends Error{constructor(e,t,n){super(e),this.code=t,this.cause=n,this.name=`KBError`}},t=class extends e{constructor(e,t){super(e,`EMBEDDING_ERROR`,t),this.name=`EmbeddingError`}},n=class extends e{constructor(e,t){super(e,`STORE_ERROR`,t),this.name=`StoreError`}},r=class extends e{constructor(e,t){super(e,`INDEX_ERROR`,t),this.name=`IndexError`}},i=class extends e{constructor(e,t){super(e,`CONFIG_ERROR`,t),this.name=`ConfigError`}};export{i as ConfigError,t as EmbeddingError,r as IndexError,e as KBError,n as StoreError};
+//# sourceMappingURL=errors.js.map

package/packages/core/dist/index.d.ts

@@ -1,6 +1,6 @@
-export * from './constants.js';
-export { contentTypeToSourceType, detectContentType, sourceTypeContentTypes, } from './content-detector.js';
-export * from './errors.js';
-export * from './logger.js';
-export * from './types.js';
-//# sourceMappingURL=index.d.ts.map
+import { CATEGORY_PATTERN, CHUNK_SIZES, DEFAULT_CATEGORIES, EMBEDDING_DEFAULTS, FILE_LIMITS, SEARCH_DEFAULTS, STORE_DEFAULTS } from "./constants.js";
+import { CONTENT_TYPES, ChunkMetadata, ContentType, IndexStats, KBConfig, KNOWLEDGE_ORIGINS, KnowledgeOrigin, KnowledgeRecord, RawChunk, SOURCE_TYPES, SearchResult, SourceType } from "./types.js";
+import { contentTypeToSourceType, detectContentType, sourceTypeContentTypes } from "./content-detector.js";
+import { ConfigError, EmbeddingError, IndexError, KBError, StoreError } from "./errors.js";
+import { LogLevel, createLogger, getLogLevel, serializeError, setLogLevel } from "./logger.js";
+export { CATEGORY_PATTERN, CHUNK_SIZES, CONTENT_TYPES, ChunkMetadata, ConfigError, ContentType, DEFAULT_CATEGORIES, EMBEDDING_DEFAULTS, EmbeddingError, FILE_LIMITS, IndexError, IndexStats, KBConfig, KBError, KNOWLEDGE_ORIGINS, KnowledgeOrigin, KnowledgeRecord, LogLevel, RawChunk, SEARCH_DEFAULTS, SOURCE_TYPES, STORE_DEFAULTS, SearchResult, SourceType, StoreError, contentTypeToSourceType, createLogger, detectContentType, getLogLevel, serializeError, setLogLevel, sourceTypeContentTypes };

package/packages/core/dist/index.js

@@ -1 +1 @@
-export*from"./constants.js";import{contentTypeToSourceType as r,detectContentType as p,sourceTypeContentTypes as n}from"./content-detector.js";export*from"./errors.js";export*from"./logger.js";export*from"./types.js";export{r as contentTypeToSourceType,p as detectContentType,n as sourceTypeContentTypes};
+import{CATEGORY_PATTERN as e,CHUNK_SIZES as t,DEFAULT_CATEGORIES as n,EMBEDDING_DEFAULTS as r,FILE_LIMITS as i,SEARCH_DEFAULTS as a,STORE_DEFAULTS as o}from"./constants.js";import{contentTypeToSourceType as s,detectContentType as c,sourceTypeContentTypes as l}from"./content-detector.js";import{ConfigError as u,EmbeddingError as d,IndexError as f,KBError as p,StoreError as m}from"./errors.js";import{createLogger as h,getLogLevel as g,serializeError as _,setLogLevel as v}from"./logger.js";import{CONTENT_TYPES as y,KNOWLEDGE_ORIGINS as b,SOURCE_TYPES as x}from"./types.js";export{e as CATEGORY_PATTERN,t as CHUNK_SIZES,y as CONTENT_TYPES,u as ConfigError,n as DEFAULT_CATEGORIES,r as EMBEDDING_DEFAULTS,d as EmbeddingError,i as FILE_LIMITS,f as IndexError,p as KBError,b as KNOWLEDGE_ORIGINS,a as SEARCH_DEFAULTS,x as SOURCE_TYPES,o as STORE_DEFAULTS,m as StoreError,s as contentTypeToSourceType,h as createLogger,c as detectContentType,g as getLogLevel,_ as serializeError,v as setLogLevel,l as sourceTypeContentTypes};

package/packages/core/dist/logger.d.ts

@@ -1,9 +1,18 @@
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
-export declare function setLogLevel(level: LogLevel): void;
-export declare function createLogger(component: string): {
-    debug: (msg: string, data?: Record<string, unknown>) => void;
-    info: (msg: string, data?: Record<string, unknown>) => void;
-    warn: (msg: string, data?: Record<string, unknown>) => void;
-    error: (msg: string, data?: Record<string, unknown>) => void;
+//#region packages/core/src/logger.d.ts
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+declare function setLogLevel(level: LogLevel): void;
+declare function getLogLevel(): LogLevel;
+/**
+ * Serialize an unknown error into a structured record suitable for JSON logging.
+ * Includes stack traces only at debug level to keep production logs concise.
+ */
+declare function serializeError(err: unknown): Record<string, unknown>;
+declare function createLogger(component: string): {
+  debug: (msg: string, data?: Record<string, unknown>) => void;
+  info: (msg: string, data?: Record<string, unknown>) => void;
+  warn: (msg: string, data?: Record<string, unknown>) => void;
+  error: (msg: string, data?: Record<string, unknown>) => void;
 };
+//#endregion
+export { LogLevel, createLogger, getLogLevel, serializeError, setLogLevel };
 //# sourceMappingURL=logger.d.ts.map

package/packages/core/dist/logger.js

@@ -1 +1,2 @@
-const t={debug:0,info:1,warn:2,error:3};let g=process.env.KB_LOG_LEVEL??"info";function s(o){g=o}function u(o){function e(n,r,i){if(t[n]<t[g])return;const L={ts:new Date().toISOString(),level:n,component:o,msg:r,...i};console.error(JSON.stringify(L))}return{debug:(n,r)=>e("debug",n,r),info:(n,r)=>e("info",n,r),warn:(n,r)=>e("warn",n,r),error:(n,r)=>e("error",n,r)}}export{u as createLogger,s as setLogLevel};
+const e={debug:0,info:1,warn:2,error:3};let t=process.env.KB_LOG_LEVEL??`info`;function n(e){t=e}function r(){return t}function i(e){if(e instanceof Error){let n={error:e.message};return t===`debug`&&e.stack&&(n.stack=e.stack),n}return{error:String(e)}}function a(n){function r(r,i,a){if(e[r]<e[t])return;let o={ts:new Date().toISOString(),level:r,component:n,msg:i,...a};console.error(JSON.stringify(o))}return{debug:(e,t)=>r(`debug`,e,t),info:(e,t)=>r(`info`,e,t),warn:(e,t)=>r(`warn`,e,t),error:(e,t)=>r(`error`,e,t)}}export{a as createLogger,r as getLogLevel,i as serializeError,n as setLogLevel};
+//# sourceMappingURL=logger.js.map

package/packages/core/dist/types.d.ts

@@ -1,110 +1,126 @@
+//#region packages/core/src/types.d.ts
 /**
  * Core types for the MCP Knowledge Base system.
  */
 /** The origin of a knowledge record — how it was created */
-export type KnowledgeOrigin = 'indexed' | 'curated' | 'produced';
+declare const KNOWLEDGE_ORIGINS: readonly ["indexed", "curated", "produced"];
+type KnowledgeOrigin = (typeof KNOWLEDGE_ORIGINS)[number];
 /** Coarse source classification derived from ContentType */
-export type SourceType = 'source' | 'documentation' | 'test' | 'config' | 'generated';
+declare const SOURCE_TYPES: readonly ["source", "documentation", "test", "config", "generated"];
+type SourceType = (typeof SOURCE_TYPES)[number];
 /** Content type classification */
-export type ContentType = 'documentation' | 'code-typescript' | 'code-javascript' | 'code-python' | 'code-other' | 'config-json' | 'config-yaml' | 'config-toml' | 'config-env' | 'test-code' | 'cdk-stack' | 'markdown' | 'curated-knowledge' | 'produced-knowledge' | 'unknown';
+declare const CONTENT_TYPES: readonly ["documentation", "code-typescript", "code-javascript", "code-python", "code-other", "config-json", "config-yaml", "config-toml", "config-env", "test-code", "cdk-stack", "markdown", "curated-knowledge", "produced-knowledge", "unknown"];
+type ContentType = (typeof CONTENT_TYPES)[number];
 /** A single knowledge record stored in the vector DB */
-export interface KnowledgeRecord {
-    /** Unique identifier (deterministic hash of source + chunk index) */
-    id: string;
-    /** The text content of this chunk */
-    content: string;
-    /** Source file path relative to workspace root */
-    sourcePath: string;
-    /** Content type classification */
-    contentType: ContentType;
-    /** Heading path for markdown (e.g., "## Setup > ### Prerequisites") */
-    headingPath?: string;
-    /** Zero-based chunk index within the source file */
-    chunkIndex: number;
-    /** Total number of chunks from this source file */
-    totalChunks: number;
-    /** Start line in source file (1-based) */
-    startLine: number;
-    /** End line in source file (1-based) */
-    endLine: number;
-    /** File hash for incremental indexing */
-    fileHash: string;
-    /** ISO timestamp when this record was created/updated */
-    indexedAt: string;
-    /** How this record was created */
-    origin: KnowledgeOrigin;
-    /** User-defined tags for categorization */
-    tags: string[];
-    /** Category for curated/produced knowledge */
-    category?: string;
-    /** Version number for curated knowledge updates */
-    version: number;
+interface KnowledgeRecord {
+  /** Unique identifier (deterministic hash of source + chunk index) */
+  id: string;
+  /** The text content of this chunk */
+  content: string;
+  /** Source file path relative to workspace root */
+  sourcePath: string;
+  /** Content type classification */
+  contentType: ContentType;
+  /** Heading path for markdown (e.g., "## Setup > ### Prerequisites") */
+  headingPath?: string;
+  /** Zero-based chunk index within the source file */
+  chunkIndex: number;
+  /** Total number of chunks from this source file */
+  totalChunks: number;
+  /** Start line in source file (1-based) */
+  startLine: number;
+  /** End line in source file (1-based) */
+  endLine: number;
+  /** File hash for incremental indexing */
+  fileHash: string;
+  /** ISO timestamp when this record was created/updated */
+  indexedAt: string;
+  /** How this record was created */
+  origin: KnowledgeOrigin;
+  /** User-defined tags for categorization */
+  tags: string[];
+  /** Category for curated/produced knowledge */
+  category?: string;
+  /** Version number for curated knowledge updates */
+  version: number;
 }
 /** A raw chunk produced by a chunker before embedding */
-export interface RawChunk {
-    /** The text content */
-    text: string;
-    /** Source file path */
-    sourcePath: string;
-    /** Content type */
-    contentType: ContentType;
-    /** Heading path (markdown only) */
-    headingPath?: string;
-    /** Chunk index */
-    chunkIndex: number;
-    /** Total chunks from this file */
-    totalChunks: number;
-    /** Start line (1-based) */
-    startLine: number;
-    /** End line (1-based) */
-    endLine: number;
+interface RawChunk {
+  /** The text content */
+  text: string;
+  /** Source file path */
+  sourcePath: string;
+  /** Content type */
+  contentType: ContentType;
+  /** Heading path (markdown only) */
+  headingPath?: string;
+  /** Chunk index */
+  chunkIndex: number;
+  /** Total chunks from this file */
+  totalChunks: number;
+  /** Start line (1-based) */
+  startLine: number;
+  /** End line (1-based) */
+  endLine: number;
 }
 /** Metadata passed to a chunker */
-export interface ChunkMetadata {
-    /** File path relative to workspace root */
-    sourcePath: string;
-    /** Detected content type */
-    contentType: ContentType;
+interface ChunkMetadata {
+  /** File path relative to workspace root */
+  sourcePath: string;
+  /** Detected content type */
+  contentType: ContentType;
 }
 /** Search result returned by the store */
-export interface SearchResult {
-    /** The matching knowledge record */
-    record: KnowledgeRecord;
-    /** Similarity score (0-1, higher = more similar) */
-    score: number;
+interface SearchResult {
+  /** The matching knowledge record */
+  record: KnowledgeRecord;
+  /** Similarity score (0-1, higher = more similar) */
+  score: number;
 }
 /** Configuration loaded from kb.config.json */
-export interface KBConfig {
-    sources: Array<{
-        path: string;
-        excludePatterns: string[];
-    }>;
-    indexing: {
-        chunkSize: number;
-        chunkOverlap: number;
-        minChunkSize: number;
-        /** Max files processed concurrently. Defaults to half of available CPU cores. */
-        concurrency?: number;
-    };
-    embedding: {
-        model: string;
-        dimensions: number;
-    };
-    store: {
-        backend: string;
-        path: string;
-    };
-    curated: {
-        path: string;
-    };
+interface KBConfig {
+  /** MCP server name. Defaults to 'kb'. */
+  serverName?: string;
+  sources: Array<{
+    path: string;
+    excludePatterns: string[];
+  }>;
+  indexing: {
+    chunkSize: number;
+    chunkOverlap: number;
+    minChunkSize: number; /** Max files processed concurrently. Defaults to half of available CPU cores. */
+    concurrency?: number;
+  };
+  embedding: {
+    model: string;
+    dimensions: number;
+  };
+  store: {
+    backend: string;
+    path: string;
+  };
+  curated: {
+    path: string;
+  };
+  /** Enterprise RAG bridge configuration (optional) */
+  er?: {
+    /** Whether ER integration is enabled */enabled: boolean; /** Base URL of the ER API (e.g., https://xxx.execute-api.region.amazonaws.com/prod) */
+    baseUrl: string; /** Request timeout in milliseconds. Defaults to 5000. */
+    timeoutMs?: number; /** Cache TTL in milliseconds. Defaults to 21600000 (6 hours). */
+    cacheTtlMs?: number; /** Maximum cache entries. Defaults to 100. */
+    cacheMaxEntries?: number; /** Vector similarity threshold below which ER fallback triggers. Defaults to 0.45. */
+    fallbackThreshold?: number;
+  };
 }
 /** Index statistics */
-export interface IndexStats {
-    totalRecords: number;
-    totalFiles: number;
-    contentTypeBreakdown: Record<string, number>;
-    lastIndexedAt: string | null;
-    storeBackend: string;
-    embeddingModel: string;
+interface IndexStats {
+  totalRecords: number;
+  totalFiles: number;
+  contentTypeBreakdown: Record<string, number>;
+  lastIndexedAt: string | null;
+  storeBackend: string;
+  embeddingModel: string;
 }
+//#endregion
+export { CONTENT_TYPES, ChunkMetadata, ContentType, IndexStats, KBConfig, KNOWLEDGE_ORIGINS, KnowledgeOrigin, KnowledgeRecord, RawChunk, SOURCE_TYPES, SearchResult, SourceType };
 //# sourceMappingURL=types.d.ts.map

package/packages/core/dist/types.js

@@ -0,0 +1,2 @@
+const e=[`indexed`,`curated`,`produced`],t=[`source`,`documentation`,`test`,`config`,`generated`],n=[`documentation`,`code-typescript`,`code-javascript`,`code-python`,`code-other`,`config-json`,`config-yaml`,`config-toml`,`config-env`,`test-code`,`cdk-stack`,`markdown`,`curated-knowledge`,`produced-knowledge`,`unknown`];export{n as CONTENT_TYPES,e as KNOWLEDGE_ORIGINS,t as SOURCE_TYPES};
+//# sourceMappingURL=types.js.map

package/packages/embeddings/dist/embedder.interface.d.ts

@@ -1,24 +1,27 @@
+//#region packages/embeddings/src/embedder.interface.d.ts
 /**
  * Embedding abstraction — allows swapping embedding models.
  */
-export interface IEmbedder {
-    /** Generate an embedding vector for a single text string (used for documents/passages) */
-    embed(text: string): Promise<Float32Array>;
-    /**
-     * Generate an embedding vector for a search query.
-     * Some models (e.g., BGE) use a query prefix for asymmetric retrieval.
-     * Falls back to embed() if the model doesn't need query prefixing.
-     */
-    embedQuery(query: string): Promise<Float32Array>;
-    /** Generate embeddings for multiple text strings (batched, for documents/passages) */
-    embedBatch(texts: string[]): Promise<Float32Array[]>;
-    /** The dimensionality of the embedding vectors */
-    readonly dimensions: number;
-    /** The model identifier */
-    readonly modelId: string;
-    /** Initialize the model (download if needed, load into memory) */
-    initialize(): Promise<void>;
-    /** Release model resources */
-    shutdown?(): Promise<void>;
+interface IEmbedder {
+  /** Generate an embedding vector for a single text string (used for documents/passages) */
+  embed(text: string): Promise<Float32Array>;
+  /**
+   * Generate an embedding vector for a search query.
+   * Some models (e.g., BGE) use a query prefix for asymmetric retrieval.
+   * Falls back to embed() if the model doesn't need query prefixing.
+   */
+  embedQuery(query: string): Promise<Float32Array>;
+  /** Generate embeddings for multiple text strings (batched, for documents/passages) */
+  embedBatch(texts: string[]): Promise<Float32Array[]>;
+  /** The dimensionality of the embedding vectors */
+  readonly dimensions: number;
+  /** The model identifier */
+  readonly modelId: string;
+  /** Initialize the model (download if needed, load into memory) */
+  initialize(): Promise<void>;
+  /** Release model resources */
+  shutdown?(): Promise<void>;
 }
+//#endregion
+export { IEmbedder };
 //# sourceMappingURL=embedder.interface.d.ts.map

package/packages/embeddings/dist/embedder.interface.js

@@ -0,0 +1 @@
+export{};

package/packages/embeddings/dist/index.d.ts

@@ -1,3 +1,3 @@
-export type { IEmbedder } from './embedder.interface.js';
-export { OnnxEmbedder } from './onnx-embedder.js';
-//# sourceMappingURL=index.d.ts.map
+import { IEmbedder } from "./embedder.interface.js";
+import { OnnxEmbedder } from "./onnx-embedder.js";
+export { type IEmbedder, OnnxEmbedder };

package/packages/embeddings/dist/index.js

@@ -1 +1 @@
-import{OnnxEmbedder as d}from"./onnx-embedder.js";export{d as OnnxEmbedder};
+import{OnnxEmbedder as e}from"./onnx-embedder.js";export{e as OnnxEmbedder};

package/packages/embeddings/dist/onnx-embedder.d.ts

@@ -1,24 +1,23 @@
-/**
- * ONNX-based embedder using @huggingface/transformers.
- * Uses mixedbread-ai/mxbai-embed-large-v1 (1024 dimensions, ~1.3GB ONNX model).
- * BGE-derived models use query prefixing for asymmetric retrieval (short query → long document).
- */
-import type { IEmbedder } from './embedder.interface.js';
-export declare class OnnxEmbedder implements IEmbedder {
-    private pipe;
-    readonly dimensions: number;
-    readonly modelId: string;
-    private readonly queryPrefix;
-    constructor(options?: {
-        model?: string;
-        dimensions?: number;
-        queryPrefix?: string;
-    });
-    private detectQueryPrefix;
-    initialize(): Promise<void>;
-    shutdown(): Promise<void>;
-    embed(text: string): Promise<Float32Array>;
-    embedQuery(query: string): Promise<Float32Array>;
-    embedBatch(texts: string[]): Promise<Float32Array[]>;
+import { IEmbedder } from "./embedder.interface.js";
+
+//#region packages/embeddings/src/onnx-embedder.d.ts
+declare class OnnxEmbedder implements IEmbedder {
+  private pipe;
+  readonly dimensions: number;
+  readonly modelId: string;
+  private readonly queryPrefix;
+  constructor(options?: {
+    model?: string;
+    dimensions?: number;
+    queryPrefix?: string;
+  });
+  private detectQueryPrefix;
+  initialize(): Promise<void>;
+  shutdown(): Promise<void>;
+  embed(text: string): Promise<Float32Array>;
+  embedQuery(query: string): Promise<Float32Array>;
+  embedBatch(texts: string[]): Promise<Float32Array[]>;
 }
+//#endregion
+export { OnnxEmbedder };
 //# sourceMappingURL=onnx-embedder.d.ts.map

package/packages/embeddings/dist/onnx-embedder.js

@@ -1 +1,2 @@
-import{homedir as m}from"node:os";import{join as u}from"node:path";import{env as p,pipeline as c}from"@huggingface/transformers";import{EMBEDDING_DEFAULTS as l}from"../../core/dist/index.js";p.cacheDir=u(m(),".cache","huggingface","transformers-js");class w{pipe=null;dimensions;modelId;queryPrefix;constructor(e){this.modelId=e?.model??l.model,this.dimensions=e?.dimensions??l.dimensions,this.queryPrefix=e?.queryPrefix??this.detectQueryPrefix(this.modelId)}detectQueryPrefix(e){const i=e.toLowerCase();return i.includes("bge")||i.includes("mxbai-embed")?"Represent this sentence for searching relevant passages: ":i.includes("/e5-")||i.includes("multilingual-e5")?"query: ":""}async initialize(){if(!this.pipe)try{this.pipe=await c("feature-extraction",this.modelId,{dtype:"fp32"})}catch(e){throw new Error(`Failed to initialize embedding model "${this.modelId}": ${e.message}`)}}async shutdown(){this.pipe=null}async embed(e){this.pipe||await this.initialize();const i=await this.pipe?.(e,{pooling:"mean",normalize:!0});if(!i)throw new Error("Embedding pipeline returned no output");return new Float32Array(i.data)}async embedQuery(e){return this.embed(this.queryPrefix+e)}async embedBatch(e){if(e.length===0)return[];this.pipe||await this.initialize();const i=[],o=32;for(let r=0;r<e.length;r+=o){const t=e.slice(r,r+o),n=await this.pipe?.(t,{pooling:"mean",normalize:!0});if(!n)throw new Error("Embedding pipeline returned no output");if(t.length===1)i.push(new Float32Array(n.data));else for(let s=0;s<t.length;s++){const a=s*this.dimensions,d=n.data.slice(a,a+this.dimensions);i.push(new Float32Array(d))}}return i}}export{w as OnnxEmbedder};
+import{homedir as e}from"node:os";import{join as t}from"node:path";import{env as n,pipeline as r}from"@huggingface/transformers";import{EMBEDDING_DEFAULTS as i}from"../../core/dist/index.js";n.cacheDir=t(e(),`.cache`,`huggingface`,`transformers-js`);var a=class{pipe=null;dimensions;modelId;queryPrefix;constructor(e){this.modelId=e?.model??i.model,this.dimensions=e?.dimensions??i.dimensions,this.queryPrefix=e?.queryPrefix??this.detectQueryPrefix(this.modelId)}detectQueryPrefix(e){let t=e.toLowerCase();return t.includes(`bge`)||t.includes(`mxbai-embed`)?`Represent this sentence for searching relevant passages: `:t.includes(`/e5-`)||t.includes(`multilingual-e5`)?`query: `:``}async initialize(){if(!this.pipe)try{this.pipe=await r(`feature-extraction`,this.modelId,{dtype:`fp32`})}catch(e){throw Error(`Failed to initialize embedding model "${this.modelId}": ${e.message}`)}}async shutdown(){this.pipe=null}async embed(e){this.pipe||await this.initialize();let t=await this.pipe?.(e,{pooling:`mean`,normalize:!0});if(!t)throw Error(`Embedding pipeline returned no output`);return new Float32Array(t.data)}async embedQuery(e){return this.embed(this.queryPrefix+e)}async embedBatch(e){if(e.length===0)return[];this.pipe||await this.initialize();let t=[];for(let n=0;n<e.length;n+=32){let r=e.slice(n,n+32),i=await this.pipe?.(r,{pooling:`mean`,normalize:!0});if(!i)throw Error(`Embedding pipeline returned no output`);if(r.length===1)t.push(new Float32Array(i.data));else for(let e=0;e<r.length;e++){let n=e*this.dimensions,r=i.data.slice(n,n+this.dimensions);t.push(new Float32Array(r))}}return t}};export{a as OnnxEmbedder};
+//# sourceMappingURL=onnx-embedder.js.map

package/packages/enterprise-bridge/dist/cache.d.ts

@@ -0,0 +1,29 @@
+import { ERSearchResult } from "./types.js";
+
+//#region packages/enterprise-bridge/src/cache.d.ts
+declare class ERCache {
+  private readonly cache;
+  private readonly maxEntries;
+  private readonly defaultTtl;
+  constructor(options?: {
+    maxEntries?: number;
+    defaultTtl?: number;
+  });
+  /** Normalize query for cache key: lowercase, trim, collapse whitespace */
+  static normalizeKey(query: string): string;
+  get(query: string): ERSearchResult[] | undefined;
+  set(query: string, results: ERSearchResult[], ttl?: number): void;
+  /** Invalidate entries matching a topic (exact normalized key match) */
+  invalidate(query: string): boolean;
+  clear(): void;
+  get size(): number;
+  /** Get cache stats */
+  stats(): {
+    size: number;
+    maxEntries: number;
+    defaultTtlMs: number;
+  };
+}
+//#endregion
+export { ERCache };
+//# sourceMappingURL=cache.d.ts.map