BYOK provider embeddings (wave 6 chunk B): kill local transformers

Replace the @huggingface/transformers local embedder (~316MB ONNX cache)
with an EmbeddingPort seam: graph.embeddingModel (nullable "provider:id"
slug) selects an OpenRouter/OpenAI/Gemini adapter, resolved fresh per
call from settings + the auth store so key rotations land immediately.

- src/server/embeddings.ts rewritten: slug grammar, injected-fetch
  adapters (OpenRouter input_type, Gemini taskType batching, OpenAI
  index-ordered rows), honest resolution (null = skip-with-info, set
  model with missing key = honest error), embedNewNodes with model-change
  re-embed wipe + ghost pruning + usage steps, federated catalog
  (OpenRouter /api/v1/embeddings/models — VERIFIED live, the inverse
  path 404s; OpenAI text-embedding- filter; Gemini embedContent filter).
- GET /api/models/embeddings: federated catalog, empty when no keys.
- Extraction tail records stages.embedding usage into the run's money
  channel; EMBEDDING_PRICES overlay in core/prices.ts (outside the
  sync-generated block), callCost falls back to it; cost-summary folds
  the fourth stage; graph-context injection resolves its embedder per
  run, fails honestly when unconfigured, records query tokens.
- Settings: GraphSettings.embeddingModel (null factory), section parser
  validates slug shape (id may contain colons — OpenRouter :free
  suffixes, live catalog fact).
- Removal: @huggingface/transformers uninstalled, PATHS.modelCache and
  onnx tracing entries deleted, @huggingface tracing-excludes guard
  added, stale sharp/libvips comments updated to historical.

Live-verified on port 3004: catalog federates 36 rows (33 OpenRouter +
3 OpenAI), embedNewNodes embedded 10 nodes via the free liquid/lfm-2.5
model (dim 1024, 435 prompt tokens, 1 call, $0), settings PUT rejects
bad slugs with 400.

Gates: typecheck, lint, 895/895 tests, build.
This commit is contained in:
amosblomqvist
2026-09-23 03:53:57 +03:00
parent a6338511d3
commit 0a4a9a11de
29 changed files with 1233 additions and 841 deletions
+16 -1
View File
@@ -251,6 +251,13 @@ export interface GraphSettings {
clustering?: boolean;
/** The LLM cluster-namer (needs clustering). */
labeling?: boolean;
/** BYOK embeddings (wave 6, 2026-09-23): the provider embedding model
* as a "provider:id" slug (openrouter:…, openai:…, google:…). null =
* no model — embedding/clustering/injection skip honestly (info log,
* graph stays textual); no factory floor exists. Keys live in the auth
* store, resolved fresh per call. A model CHANGE re-embeds everything
* (the ledger's staleness semantics). */
embeddingModel?: string | null;
}
/** THE record. Every section optional (delta); unknown top-level keys are
@@ -303,7 +310,7 @@ export const FACTORY_SETTINGS: FactorySettings = {
sessionNameSerif: true,
mdRendering: { headingWeight: 900, boldColor: null, italicColor: null },
},
graph: { enabled: true, embedding: true, clustering: true, labeling: true },
graph: { enabled: true, embedding: true, clustering: true, labeling: true, embeddingModel: null },
};
// ─── Sanitizer ─────────────────────────────────────────────────────────────
@@ -453,6 +460,14 @@ function sanitizeGraph(raw: Record<string, unknown>): GraphSettings {
if (clustering !== undefined) out.clustering = clustering;
const labeling = boolOrDrop(raw.labeling);
if (labeling !== undefined) out.labeling = labeling;
// BYOK embeddings (wave 6): null or a provider-qualified slug; anything
// else (bad type, bad shape) DROPS to absent — an invalid write never
// becomes a live model (the PUT parser 400s it first; this is the
// read-side belt-and-suspenders for hand-edited files).
if (raw.embeddingModel === null) out.embeddingModel = null;
else if (typeof raw.embeddingModel === "string" && /^\S+:\S+$/.test(raw.embeddingModel)) {
out.embeddingModel = raw.embeddingModel;
}
return out;
}