@backendkit-labs/agent-enterprise 0.2.0 → 0.3.0

package/README.md

@@ -1,5 +1,7 @@
 # @backendkit-labs/agent-enterprise
 
+**Status: core** — RAG and VaultWriter are required for the enterprise story; changes go through full review.
+
 Enterprise knowledge layer for the BackendKit Agent Framework — local RAG over Obsidian vaults, shared knowledge vault with agent write-back, and pluggable embedders.
 
 ```bash

package/dist/index.d.ts

@@ -8,4 +8,5 @@ export { VaultIndexer } from './rag/VaultIndexer';
 export type { IndexerOptions, RawChunk } from './rag/VaultIndexer';
 export { VaultWriter } from './rag/VaultWriter';
 export type { VaultWriterOptions, WriteNoteParams } from './rag/VaultWriter';
+export { SimpleEmbedder } from './rag/SimpleEmbedder';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAC7G,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAC7G,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VaultWriter = exports.VaultIndexer = exports.VectorStore = exports.OLLAMA_EMBED_DEFAULT_MODEL = exports.OLLAMA_EMBED_DEFAULT_HOST = exports.OllamaEmbedder = exports.ObsidianRAGProvider = void 0;
+exports.SimpleEmbedder = exports.VaultWriter = exports.VaultIndexer = exports.VectorStore = exports.OLLAMA_EMBED_DEFAULT_MODEL = exports.OLLAMA_EMBED_DEFAULT_HOST = exports.OllamaEmbedder = exports.ObsidianRAGProvider = void 0;
 var ObsidianRAGProvider_1 = require("./rag/ObsidianRAGProvider");
 Object.defineProperty(exports, "ObsidianRAGProvider", { enumerable: true, get: function () { return ObsidianRAGProvider_1.ObsidianRAGProvider; } });
 var OllamaEmbedder_1 = require("./rag/OllamaEmbedder");
@@ -13,4 +13,6 @@ var VaultIndexer_1 = require("./rag/VaultIndexer");
 Object.defineProperty(exports, "VaultIndexer", { enumerable: true, get: function () { return VaultIndexer_1.VaultIndexer; } });
 var VaultWriter_1 = require("./rag/VaultWriter");
 Object.defineProperty(exports, "VaultWriter", { enumerable: true, get: function () { return VaultWriter_1.VaultWriter; } });
+var SimpleEmbedder_1 = require("./rag/SimpleEmbedder");
+Object.defineProperty(exports, "SimpleEmbedder", { enumerable: true, get: function () { return SimpleEmbedder_1.SimpleEmbedder; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iEAAgE;AAAvD,0HAAA,mBAAmB,OAAA;AAG5B,uDAA6G;AAApG,gHAAA,cAAc,OAAA;AAAE,2HAAA,yBAAyB,OAAA;AAAE,4HAAA,0BAA0B,OAAA;AAG9E,iDAAgD;AAAvC,0GAAA,WAAW,OAAA;AAGpB,mDAAkD;AAAzC,4GAAA,YAAY,OAAA;AAGrB,iDAAgD;AAAvC,0GAAA,WAAW,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iEAAgE;AAAvD,0HAAA,mBAAmB,OAAA;AAG5B,uDAA6G;AAApG,gHAAA,cAAc,OAAA;AAAE,2HAAA,yBAAyB,OAAA;AAAE,4HAAA,0BAA0B,OAAA;AAG9E,iDAAgD;AAAvC,0GAAA,WAAW,OAAA;AAGpB,mDAAkD;AAAzC,4GAAA,YAAY,OAAA;AAGrB,iDAAgD;AAAvC,0GAAA,WAAW,OAAA;AAGpB,uDAAsD;AAA7C,gHAAA,cAAc,OAAA"}

package/dist/rag/SimpleEmbedder.d.ts

@@ -0,0 +1,23 @@
+/**
+ * SimpleEmbedder — local TF-IDF with feature hashing, no external dependencies.
+ *
+ * Produces 256-dimensional unit vectors by:
+ *   1. Tokenising text into lowercase alphanumeric tokens
+ *   2. Mapping each token to a bucket via djb2 hash % DIMS
+ *   3. Accumulating term-frequency counts in the bucket
+ *   4. L2-normalising to a unit vector
+ *
+ * Not semantically equivalent to transformer embeddings, but clusters texts
+ * with shared vocabulary close together — sufficient to find notes whose
+ * content matches the query's key terms.
+ *
+ * Use this when Ollama is not available (dev, CI, pilot). For production,
+ * prefer OllamaEmbedder with nomic-embed-text for semantic accuracy.
+ */
+import type { Embedder } from './ObsidianRAGProvider';
+export declare class SimpleEmbedder implements Embedder {
+    readonly model = "simple-tfidf-256";
+    embed(texts: string[]): Promise<number[][]>;
+    embedOne(text: string): Promise<number[]>;
+}
+//# sourceMappingURL=SimpleEmbedder.d.ts.map

package/dist/rag/SimpleEmbedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleEmbedder.d.ts","sourceRoot":"","sources":["../../src/rag/SimpleEmbedder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAyCtD,qBAAa,cAAe,YAAW,QAAQ;IAC3C,QAAQ,CAAC,KAAK,sBAAsB;IAE9B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAI3C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAGlD"}

package/dist/rag/SimpleEmbedder.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * SimpleEmbedder — local TF-IDF with feature hashing, no external dependencies.
+ *
+ * Produces 256-dimensional unit vectors by:
+ *   1. Tokenising text into lowercase alphanumeric tokens
+ *   2. Mapping each token to a bucket via djb2 hash % DIMS
+ *   3. Accumulating term-frequency counts in the bucket
+ *   4. L2-normalising to a unit vector
+ *
+ * Not semantically equivalent to transformer embeddings, but clusters texts
+ * with shared vocabulary close together — sufficient to find notes whose
+ * content matches the query's key terms.
+ *
+ * Use this when Ollama is not available (dev, CI, pilot). For production,
+ * prefer OllamaEmbedder with nomic-embed-text for semantic accuracy.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimpleEmbedder = void 0;
+const DIMS = 256;
+function djb2(str) {
+    let h = 5381;
+    for (let i = 0; i < str.length; i++) {
+        h = Math.imul((h << 5) + h, 1) + str.charCodeAt(i);
+    }
+    return Math.abs(h);
+}
+function tokenise(text) {
+    return text
+        .toLowerCase()
+        .normalize('NFD')
+        .replace(/[̀-ͯ]/g, '') // strip diacritics
+        .split(/[^a-z0-9]+/)
+        .filter(t => t.length > 2); // skip 1-2 char noise tokens
+}
+function vectorise(text) {
+    const vec = new Array(DIMS).fill(0);
+    const tokens = tokenise(text);
+    if (tokens.length === 0)
+        return vec;
+    for (const t of tokens) {
+        vec[djb2(t) % DIMS] += 1;
+    }
+    // L2 normalise
+    let norm = 0;
+    for (const v of vec)
+        norm += v * v;
+    norm = Math.sqrt(norm);
+    if (norm > 0) {
+        for (let i = 0; i < DIMS; i++)
+            vec[i] /= norm;
+    }
+    return vec;
+}
+class SimpleEmbedder {
+    model = 'simple-tfidf-256';
+    async embed(texts) {
+        return texts.map(vectorise);
+    }
+    async embedOne(text) {
+        return vectorise(text);
+    }
+}
+exports.SimpleEmbedder = SimpleEmbedder;
+//# sourceMappingURL=SimpleEmbedder.js.map

package/dist/rag/SimpleEmbedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleEmbedder.js","sourceRoot":"","sources":["../../src/rag/SimpleEmbedder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAIH,MAAM,IAAI,GAAG,GAAG,CAAC;AAEjB,SAAS,IAAI,CAAC,GAAW;IACrB,IAAI,CAAC,GAAG,IAAI,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC1B,OAAO,IAAI;SACN,WAAW,EAAE;SACb,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAG,mBAAmB;SAC3C,KAAK,CAAC,YAAY,CAAC;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAS,6BAA6B;AACzE,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC3B,MAAM,GAAG,GAAG,IAAI,KAAK,CAAS,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACrB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,eAAe;IACf,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,GAAG;QAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;YAAE,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAClD,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED,MAAa,cAAc;IACd,KAAK,GAAG,kBAAkB,CAAC;IAEpC,KAAK,CAAC,KAAK,CAAC,KAAe;QACvB,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACvB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACJ;AAVD,wCAUC"}

package/package.json

@@ -1,35 +1,35 @@
-{
-  "name": "@backendkit-labs/agent-enterprise",
-  "version": "0.2.0",
-  "description": "Business agents with local LLM and RAG knowledge base for agent-core",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist/",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "jest",
-    "prepublishOnly": "npm run build"
-  },
-  "dependencies": {
-    "@backendkit-labs/agent-core": "*",
-    "yaml": "^2.4.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/jest": "^29.0.0",
-    "jest": "^29.0.0",
-    "ts-jest": "^29.0.0",
-    "typescript": "^5.4.0"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@backendkit-labs/agent-enterprise",
+  "version": "0.3.0",
+  "description": "Business agents with local LLM and RAG knowledge base for agent-core",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@backendkit-labs/agent-core": "*",
+    "yaml": "^2.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/jest": "^29.0.0",
+    "jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}