@kb-labs/mind-core 2.94.0 → 2.96.0

package/dist/testing.js

@@ -0,0 +1,169 @@
+import { mkdtempSync, mkdirSync, writeFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { join, dirname } from 'path';
+
+// src/testing.ts
+var EMBED_DIM = 64;
+var DeterministicEmbedder = class {
+  dimensions = EMBED_DIM;
+  /** Number of texts embedded — lets tests assert delta re-indexing skips work. */
+  embedCount = 0;
+  async embed(text) {
+    this.embedCount += 1;
+    const vec = new Array(EMBED_DIM).fill(0);
+    for (const token of text.toLowerCase().split(/[^a-z0-9]+/).filter(Boolean)) {
+      let h = 0;
+      for (let i = 0; i < token.length; i++) {
+        h = h * 31 + token.charCodeAt(i) >>> 0;
+      }
+      const idx = h % EMBED_DIM;
+      vec[idx] = (vec[idx] ?? 0) + 1;
+    }
+    return vec;
+  }
+  async embedBatch(texts) {
+    return Promise.all(texts.map((t) => this.embed(t)));
+  }
+  async getDimensions() {
+    return EMBED_DIM;
+  }
+};
+function cosine(a, b) {
+  let dot = 0;
+  let na = 0;
+  let nb = 0;
+  for (let i = 0; i < a.length; i++) {
+    const x = a[i] ?? 0;
+    const y = b[i] ?? 0;
+    dot += x * y;
+    na += x * x;
+    nb += y * y;
+  }
+  const d = Math.sqrt(na) * Math.sqrt(nb);
+  return d === 0 ? 0 : dot / d;
+}
+var TestVectorStore = class {
+  ns = /* @__PURE__ */ new Map();
+  part(namespace) {
+    const key = namespace ?? "";
+    let p = this.ns.get(key);
+    if (!p) {
+      p = /* @__PURE__ */ new Map();
+      this.ns.set(key, p);
+    }
+    return p;
+  }
+  async search(query, limit, _filter, namespace) {
+    return [...this.part(namespace).values()].map((r) => ({ id: r.id, score: cosine(query, r.vector), metadata: r.metadata })).sort((a, b) => b.score - a.score).slice(0, limit);
+  }
+  async upsert(vectors, namespace) {
+    const p = this.part(namespace);
+    for (const v of vectors) {
+      p.set(v.id, v);
+    }
+  }
+  async delete(ids, namespace) {
+    const p = this.part(namespace);
+    for (const id of ids) {
+      p.delete(id);
+    }
+  }
+  async count(namespace) {
+    return this.part(namespace).size;
+  }
+  async query(_filter, namespace) {
+    return [...this.part(namespace).values()];
+  }
+};
+var TestStorage = class {
+  files = /* @__PURE__ */ new Map();
+  seed(path, content) {
+    this.files.set(path, Buffer.from(content, "utf8"));
+  }
+  async read(path) {
+    return this.files.get(path) ?? null;
+  }
+  async write(path, data) {
+    this.files.set(path, data);
+  }
+  async delete(path) {
+    this.files.delete(path);
+  }
+  async list(prefix) {
+    return [...this.files.keys()].filter((p) => p.startsWith(prefix));
+  }
+  async exists(path) {
+    return this.files.has(path);
+  }
+};
+var noopLogger = {
+  debug() {
+  },
+  info() {
+  },
+  warn() {
+  },
+  error() {
+  },
+  fatal() {
+  },
+  trace() {
+  },
+  child() {
+    return noopLogger;
+  }
+};
+var stubCache = {
+  async get() {
+    return null;
+  },
+  async set() {
+  },
+  async delete() {
+  },
+  async clear() {
+  },
+  async zadd() {
+  },
+  async zrangebyscore() {
+    return [];
+  }
+};
+var stubLLM = {
+  async complete() {
+    return { content: "", usage: { promptTokens: 0, completionTokens: 0 } };
+  }
+};
+function makeScriptedLLM(content) {
+  return {
+    async complete() {
+      return { content, usage: { promptTokens: 0, completionTokens: 0 } };
+    }
+  };
+}
+function makeTestServices(overrides = {}) {
+  const storage = new TestStorage();
+  const vectorStore = new TestVectorStore();
+  return {
+    storage,
+    vectorStore,
+    embeddings: new DeterministicEmbedder(),
+    cache: stubCache,
+    llm: stubLLM,
+    logger: noopLogger,
+    ...overrides
+  };
+}
+function makeTestWorkspace(files, overrides = {}) {
+  const cwd = mkdtempSync(join(tmpdir(), "mind-test-"));
+  for (const [rel, content] of Object.entries(files)) {
+    const abs = join(cwd, rel);
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, content, "utf8");
+  }
+  return { cwd, services: makeTestServices(overrides) };
+}
+
+export { DeterministicEmbedder, TestStorage, TestVectorStore, makeScriptedLLM, makeTestServices, makeTestWorkspace };
+//# sourceMappingURL=testing.js.map
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts"],"names":[],"mappings":"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","file":"testing.js","sourcesContent":["/**\n * Functional in-memory test harness for the engine.\n *\n * `@kb-labs/sdk/testing`'s `createTestContext` returns *mock* platform services\n * (empty/noop) — fine for handler wiring, useless for exercising retrieval.\n * This harness provides REAL behaviour: a deterministic bag-of-words embedder\n * and working in-memory vector store / storage, so ingest+retrieve and\n * namespace isolation can be tested end-to-end without a daemon or network.\n *\n * Imports only types from `@kb-labs/sdk`; the implementations are local.\n */\n\nimport { mkdtempSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { tmpdir } from 'node:os';\nimport { join, dirname } from 'node:path';\nimport type {\n  MindServices,\n  IVectorStore,\n  IEmbeddings,\n  IStorage,\n  ICache,\n  ILLM,\n  ILogger,\n  VectorRecord,\n  VectorSearchResult,\n  VectorFilter,\n} from './services';\n\nconst EMBED_DIM = 64;\n\n/** Deterministic bag-of-words embedder: shared tokens → higher cosine similarity. */\nexport class DeterministicEmbedder implements IEmbeddings {\n  readonly dimensions = EMBED_DIM;\n  /** Number of texts embedded — lets tests assert delta re-indexing skips work. */\n  embedCount = 0;\n\n  async embed(text: string): Promise<number[]> {\n    this.embedCount += 1;\n    const vec = new Array<number>(EMBED_DIM).fill(0);\n    for (const token of text.toLowerCase().split(/[^a-z0-9]+/).filter(Boolean)) {\n      let h = 0;\n      for (let i = 0; i < token.length; i++) {\n        h = (h * 31 + token.charCodeAt(i)) >>> 0;\n      }\n      const idx = h % EMBED_DIM;\n      vec[idx] = (vec[idx] ?? 0) + 1;\n    }\n    return vec;\n  }\n\n  async embedBatch(texts: string[]): Promise<number[][]> {\n    return Promise.all(texts.map((t) => this.embed(t)));\n  }\n\n  async getDimensions(): Promise<number> {\n    return EMBED_DIM;\n  }\n}\n\nfunction cosine(a: number[], b: number[]): number {\n  let dot = 0;\n  let na = 0;\n  let nb = 0;\n  for (let i = 0; i < a.length; i++) {\n    const x = a[i] ?? 0;\n    const y = b[i] ?? 0;\n    dot += x * y;\n    na += x * x;\n    nb += y * y;\n  }\n  const d = Math.sqrt(na) * Math.sqrt(nb);\n  return d === 0 ? 0 : dot / d;\n}\n\n/** Minimal namespace-partitioned in-memory vector store (mirrors platform semantics). */\nexport class TestVectorStore implements IVectorStore {\n  private ns = new Map<string, Map<string, VectorRecord>>();\n\n  private part(namespace?: string): Map<string, VectorRecord> {\n    const key = namespace ?? '';\n    let p = this.ns.get(key);\n    if (!p) {\n      p = new Map();\n      this.ns.set(key, p);\n    }\n    return p;\n  }\n\n  async search(query: number[], limit: number, _filter?: VectorFilter, namespace?: string): Promise<VectorSearchResult[]> {\n    return [...this.part(namespace).values()]\n      .map((r) => ({ id: r.id, score: cosine(query, r.vector), metadata: r.metadata }))\n      .sort((a, b) => b.score - a.score)\n      .slice(0, limit);\n  }\n\n  async upsert(vectors: VectorRecord[], namespace?: string): Promise<void> {\n    const p = this.part(namespace);\n    for (const v of vectors) {\n      p.set(v.id, v);\n    }\n  }\n\n  async delete(ids: string[], namespace?: string): Promise<void> {\n    const p = this.part(namespace);\n    for (const id of ids) {\n      p.delete(id);\n    }\n  }\n\n  async count(namespace?: string): Promise<number> {\n    return this.part(namespace).size;\n  }\n\n  async query(_filter: VectorFilter, namespace?: string): Promise<VectorRecord[]> {\n    return [...this.part(namespace).values()];\n  }\n}\n\n/** Minimal in-memory storage with prefix listing. */\nexport class TestStorage implements IStorage {\n  private files = new Map<string, Buffer>();\n\n  seed(path: string, content: string): void {\n    this.files.set(path, Buffer.from(content, 'utf8'));\n  }\n\n  async read(path: string): Promise<Buffer | null> {\n    return this.files.get(path) ?? null;\n  }\n\n  async write(path: string, data: Buffer): Promise<void> {\n    this.files.set(path, data);\n  }\n\n  async delete(path: string): Promise<void> {\n    this.files.delete(path);\n  }\n\n  async list(prefix: string): Promise<string[]> {\n    return [...this.files.keys()].filter((p) => p.startsWith(prefix));\n  }\n\n  async exists(path: string): Promise<boolean> {\n    return this.files.has(path);\n  }\n}\n\nconst noopLogger = {\n  debug() {},\n  info() {},\n  warn() {},\n  error() {},\n  fatal() {},\n  trace() {},\n  child() {\n    return noopLogger;\n  },\n} as unknown as ILogger;\n\nconst stubCache: ICache = {\n  async get() {\n    return null;\n  },\n  async set() {},\n  async delete() {},\n  async clear() {},\n  async zadd() {},\n  async zrangebyscore() {\n    return [];\n  },\n} as unknown as ICache;\n\nconst stubLLM: ILLM = {\n  async complete() {\n    return { content: '', usage: { promptTokens: 0, completionTokens: 0 } };\n  },\n} as unknown as ILLM;\n\n/** Scripted LLM that returns a fixed completion — for testing agent synthesis. */\nexport function makeScriptedLLM(content: string): ILLM {\n  return {\n    async complete() {\n      return { content, usage: { promptTokens: 0, completionTokens: 0 } };\n    },\n  } as unknown as ILLM;\n}\n\nexport interface TestServices extends MindServices {\n  storage: TestStorage;\n  vectorStore: TestVectorStore;\n}\n\n/** Build functional in-memory `MindServices` for engine tests. */\nexport function makeTestServices(overrides: Partial<MindServices> = {}): TestServices {\n  const storage = new TestStorage();\n  const vectorStore = new TestVectorStore();\n  return {\n    storage,\n    vectorStore,\n    embeddings: new DeterministicEmbedder(),\n    cache: stubCache,\n    llm: stubLLM,\n    logger: noopLogger,\n    ...overrides,\n  } as TestServices;\n}\n\nexport interface TestWorkspace {\n  /** Workspace root (a real temp dir) — pass as `createMind(..., { cwd })`. */\n  cwd: string;\n  /** In-memory services (vector store + manifest storage). */\n  services: TestServices;\n}\n\n/**\n * Materialize source files on disk (a temp dir) so the engine exercises its\n * REAL discovery (globby + fs + ignores) instead of in-memory seeding — this is\n * what catches discovery bugs (e.g. node_modules recursion). The vector store\n * and manifest stay in-memory via `makeTestServices`.\n */\nexport function makeTestWorkspace(\n  files: Record<string, string>,\n  overrides: Partial<MindServices> = {},\n): TestWorkspace {\n  const cwd = mkdtempSync(join(tmpdir(), 'mind-test-'));\n  for (const [rel, content] of Object.entries(files)) {\n    const abs = join(cwd, rel);\n    mkdirSync(dirname(abs), { recursive: true });\n    writeFileSync(abs, content, 'utf8');\n  }\n  return { cwd, services: makeTestServices(overrides) };\n}\n"]}

package/package.json

@@ -1,15 +1,18 @@
 {
   "name": "@kb-labs/mind-core",
-  "description": "Core contracts, errors, and utilities for KB Labs Mind",
-  "version": "2.94.0",
+  "description": "Core RAG engine for KB Labs Mind: ingest, retrieval, answer. Dry business logic over platform adapters.",
+  "version": "2.96.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
+      "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
     },
     "./dist/*": "./dist/*"
   },
@@ -19,16 +22,17 @@
     "LICENSE"
   ],
   "dependencies": {
+    "globby": "^11.0.0",
     "@kb-labs/sdk": "2.21.2",
-    "@kb-labs/mind-types": "2.94.0"
+    "@kb-labs/mind-contracts": "2.96.0"
   },
   "devDependencies": {
     "@types/node": "^24.3.3",
     "rimraf": "^6.0.1",
     "tsup": "^8.5.0",
     "typescript": "^5.6.3",
-    "vitest": "^3.2.4",
-    "@kb-labs/devkit": "2.94.0"
+    "vitest": "^3.2.6",
+    "@kb-labs/devkit": "2.96.0"
   },
   "engines": {
     "node": ">=20.0.0",
@@ -39,8 +43,9 @@
     "build": "tsup --config tsup.config.ts",
     "clean": "rimraf dist",
     "dev": "tsup --config tsup.config.ts --watch",
-    "lint": "eslint src --ext .ts,.tsx,.js,.jsx",
+    "lint": "eslint src --ext .ts",
     "lint:fix": "eslint . --fix",
+    "pretype-check": "pnpm --filter @kb-labs/mind-core build",
     "test": "vitest run --passWithNoTests",
     "test:watch": "vitest",
     "type-check": "tsc --noEmit"