omnigraph/docs/user
Ragnor Comerford ffb4a2c9ab
fix(embedding): openai-alias api key + deadline scope (PR review)
openai-alias api key (Cursor High): key resolution was dispatched on the Provider enum, which is OpenAiCompatible for both openai and openai-compatible, so OMNIGRAPH_EMBED_PROVIDER=openai (base api.openai.com) could send OPENROUTER_API_KEY and 401. Fix: the alias match now yields the ordered key-env list too, so base, model and key are all alias-derived in one place. openai takes only OPENAI_API_KEY (errors loudly if absent); openai-compatible/unset prefer OPENROUTER_API_KEY then OPENAI_API_KEY. Closes the class, not the instance.

deadline scope (Cursor Medium): the deadline bounds every embed call (query and document), which is correct, but the name said query-only. Renamed OMNIGRAPH_EMBED_QUERY_DEADLINE_MS -> OMNIGRAPH_EMBED_DEADLINE_MS (field query_deadline_ms -> deadline_ms) and updated the doc wording so the name matches the behavior. Two new alias-key tests; 20 embedding unit tests pass.

Resolved earlier in 30377c4: openai-alias base URL, single embed-model source, stale @embed ingest docs. Declined: RFC Status (the lifecycle keeps it Proposed while the PR is open).
2026-06-15 21:44:31 +02:00
..
branching docs(user): de-dev polish — strip internal scaffolding from user docs (Phase 3a) (#226) 2026-06-14 14:39:25 +03:00
cli feat(cli)!: remove legacy data-plane addressing (--target, positional http→remote, --as-on-served) (#238) 2026-06-15 04:29:16 +03:00
clusters feat(cli)!: remove legacy data-plane addressing (--target, positional http→remote, --as-on-served) (#238) 2026-06-15 04:29:16 +03:00
concepts docs(user): de-dev polish — strip internal scaffolding from user docs (Phase 3a) (#226) 2026-06-14 14:39:25 +03:00
mutations docs(user): split language/branching pages + add front-door pages (Phase 2) (#225) 2026-06-14 13:53:46 +03:00
operations feat(cli)!: remove legacy data-plane addressing (--target, positional http→remote, --as-on-served) (#238) 2026-06-15 04:29:16 +03:00
queries docs(user): de-dev polish — strip internal scaffolding from user docs (Phase 3a) (#226) 2026-06-14 14:39:25 +03:00
reference docs(user): de-dev polish — strip internal scaffolding from user docs (Phase 3a) (#226) 2026-06-14 14:39:25 +03:00
schema docs(embeddings): @embed model arg + same-space validation (RFC-012 Phase 3-4) 2026-06-15 21:09:35 +02:00
search fix(embedding): openai-alias api key + deadline scope (PR review) 2026-06-15 21:44:31 +02:00
deployment.md docs(user): de-dev polish — strip internal scaffolding from user docs (Phase 3a) (#226) 2026-06-14 14:39:25 +03:00
index.md docs(user): split language/branching pages + add front-door pages (Phase 2) (#225) 2026-06-14 13:53:46 +03:00
install.md Add Windows release binaries (#127) 2026-05-30 14:23:40 +02:00
quickstart.md docs(user): split language/branching pages + add front-door pages (Phase 2) (#225) 2026-06-14 13:53:46 +03:00