@remit/backend 0.0.28 → 0.0.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/src/service/semantic-capability.ts +17 -8
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@remit/backend",
3
- "version": "0.0.28",
3
+ "version": "0.0.29",
4
4
  "description": "Remit Mail Inspector API backend",
5
5
  "license": "MIT",
6
6
  "author": "",
package/src/service/semantic-capability.ts CHANGED
@@ -4,14 +4,23 @@ import { isSelfHostSqlBackend } from "../data-backend.js";
4
4
  /**
5
5
  * Semantic-search capability gate for the self-host compose profiles.
6
6
  *
7
- * The backend container image ships neither `@huggingface/transformers` (query
8
- * embedding) nor `sqlite-vec` (the vector store's loadable extension, glibc-only
9
- * on top of that — see npm-scripts/docker-bundle.mjs and deploy/vps/README.md).
10
- * Both are reached lazily through `runtimeImport`, so the first semantic query —
11
- * not startup — hits ERR_MODULE_NOT_FOUND. Without this gate every search the
12
- * web client issues fires a `/search/semantic` request that 500s (the client
13
- * fetches semantic hits alongside every literal search), retried by the client
14
- * on top.
7
+ * This gates the free-text `/search/semantic` path only. Answering that query
8
+ * means embedding it in-process, and the backend container image ships without
9
+ * `@huggingface/transformers` (the model plus its dependencies would roughly
10
+ * quadruple the image — see npm-scripts/docker-bundle.mjs and
11
+ * deploy/vps/README.md). The embedder is reached lazily through `runtimeImport`,
12
+ * so the first semantic query — not startup — hits ERR_MODULE_NOT_FOUND. Without
13
+ * this gate every search the web client issues fires a `/search/semantic`
14
+ * request that 500s (the client fetches semantic hits alongside every literal
15
+ * search), retried by the client on top.
16
+ *
17
+ * The vector STORE is a separate capability and is NOT gated here. The Organize
18
+ * anchor widen (organize.ts matchSemantic) pools an anchor message's already
19
+ * stored chunk vectors and runs a KNN read over the vector store — no embedding
20
+ * model involved — so it needs only `sqlite-vec`, which the backend image now
21
+ * carries as a musl build (Dockerfile sqlite-vec-musl stage,
22
+ * SQLITE_VEC_EXTENSION_PATH). matchOrganize never consults the memoized flag
23
+ * below; a missing embedder therefore never disables the widen.
15
24
  *
16
25
  * The e2e-dev lane runs this backend from source rather than the container, so
17
26
  * `@huggingface/transformers` IS present and the local embedder instead tries to