BE-622: Move semantic search embedding generation into the graph

[TimDiekmann]

Purpose

Move semantic-search embedding generation out of the Node SDK (which did a Temporal roundtrip to the ai worker) into the graph. The /entities/search and /entity-types/search endpoints now accept a semanticString and resolve it to an embedding by calling OpenAI directly, configured via HASH_GRAPH_OPENAI_API_KEY.

Builds on the dedicated search endpoints from BE-471/BE-621 (#8910, merged); targets main.

Linear: BE-622

What does this change?

• New hash-graph-embeddings crate — provider-agnostic EmbeddingGenerator trait + OpenAiEmbeddingClient (own thin reqwest + reqwest-retry client, no async-openai). Model text-embedding-3-large / 3072 dims, pinned to match the TS indexer.
• Graph — HASH_GRAPH_OPENAI_API_KEY wired in like the Temporal client; search endpoints accept embedding xor semanticString; provider failures are classified (auth / rate-limit / outage) and mapped to 429/503/500 instead of a blanket 500; a caller-supplied embedding is validated against Embedding::DIM; startup logs whether semantic search is enabled.
• Node SDK — searchEntities/searchEntityTypes forward semanticString directly and no longer take a temporalClient; dead calculateEmbedding removed (CreateEmbeddings* types kept for the worker's indexing path).
• Docs / infra — OpenAPI regenerated; the mise run sync:turborepo task documented in AGENTS.md; HASH_GRAPH_OPENAI_API_KEY wired into the compose graph service.

Pre-merge checklist

• New Rust crate is publish = false; no other publishable-package changes.
• Docs updated (AGENTS.md); no Petrinaut changes.
• Turbo graph gains @rust/hash-graph-embeddings.

How to test

Set HASH_GRAPH_OPENAI_API_KEY, start the graph, and POST /entities/search with { "semanticString": "...", "maximumSemanticDistance": 0.7 }. Without a key configured, semantic-string search returns a clean "unavailable" error and the startup log warns; the precomputed-embedding path needs no key.

Notes / follow-ups

• Reviewed with the pr-review-toolkit agents (two rounds); findings addressed.
• Deferred: HTTP-mock unit tests for the OpenAI client; honoring Retry-After (intentionally fail-fast for the interactive path); splitting EmbeddingError::Request build-vs-send.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
hash	Ready	Preview, Comment	Jul 6, 2026 12:48pm
hashdotdesign-tokens	Ready	Preview, Comment	Jul 6, 2026 12:48pm
petrinaut	Ready	Preview, Comment	Jul 6, 2026 12:48pm

[cursor]

PR Summary

Medium Risk
Search requests now depend on OpenAI availability and API key handling on the graph path; misconfiguration or provider outages affect semantic search directly, though precomputed embeddings still work without a key.

Overview
Moves semantic-search embedding generation from the Node SDK (Temporal → AI worker) into the graph service.

A new hash-graph-embeddings crate exposes an EmbeddingGenerator and OpenAiEmbeddingClient (text-embedding-3-large, retries, classified provider errors). The graph server reads HASH_GRAPH_OPENAI_API_KEY (HASH_GRAPH_OPENAI_API_KEY in compose); when unset or empty, semantic-string search is disabled and callers must pass a precomputed embedding.

/entities/search and /entity-types/search now accept embedding xor semanticString, resolved via resolve_search_embedding with validation (dimensions, mutual exclusivity, client availability) and HTTP status mapping for rate limits and outages. OpenAPI and router dependencies are updated accordingly.

The TypeScript SDK drops temporalClient and client-side calculateEmbedding; search helpers forward semanticString to the graph API. Embedding::len / is_empty support dimension checks; AGENTS.md documents mise run sync:turborepo for Rust crate wiring.

^{Reviewed by Cursor Bugbot for commit f3b4fcf. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-advanced-security]

You are seeing this message because GitHub Code Scanning has recently been set up for this repository, or this pull request contains the workflow file for the Code Scanning tool.

What Enabling Code Scanning Means:

• The 'Security' tab will display more code scanning analysis results (e.g., for the default branch).
• Depending on your configuration and choice of analysis tool, future pull requests will be annotated with code scanning analysis results.
• You will be able to see the analysis results for the pull request's branch on this overview once the scans have completed and the checks have passed.

For more information about GitHub Code Scanning, check out the documentation.

[Copilot]

Pull request overview

Moves semantic-search embedding generation from the TypeScript/Temporal path into the Rust graph service so /entities/search and /entity-types/search can accept a semanticString and resolve it to an embedding server-side (OpenAI), gated by HASH_GRAPH_OPENAI_API_KEY.

Changes:

• Adds a new Rust workspace crate hash-graph-embeddings with a provider-agnostic EmbeddingGenerator trait and an OpenAI-backed client implementation.
• Updates graph REST search request handling to accept embedding xor semanticString, resolve/validate embeddings, and classify provider failures into more specific status codes.
• Removes the Node SDK’s Temporal-based calculateEmbedding path and forwards semanticString directly; wires the API key into docker-compose and updates agent docs.

Reviewed changes

Copilot reviewed 25 out of 27 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
yarn.lock	Adds the new @rust/hash-graph-embeddings workspace package to Yarn dependencies.
libs/@local/graph/types/src/embedding.rs	Adds len() / is_empty() helpers used for embedding validation.
libs/@local/graph/sdk/typescript/src/entity.ts	Removes Temporal dependency and forwards semanticString directly to graph API search.
libs/@local/graph/sdk/typescript/src/entity-type.ts	Removes Temporal dependency and forwards semanticString directly to graph API search.
libs/@local/graph/sdk/typescript/src/embeddings.ts	Removes the Temporal-based calculateEmbedding implementation (keeps types).
libs/@local/graph/embeddings/src/openai.rs	Implements OpenAI embeddings client with retries, timeout, and response validation.
libs/@local/graph/embeddings/src/lib.rs	Introduces EmbeddingGenerator trait and re-exports public client types.
libs/@local/graph/embeddings/src/error.rs	Defines typed embedding-generation error taxonomy.
libs/@local/graph/embeddings/package.json	Adds Turborepo wiring + scripts for the new Rust crate package.
libs/@local/graph/embeddings/LICENSE.md	Adds crate-level license text.
libs/@local/graph/embeddings/docs/dependency-diagram.mmd	Adds dependency diagram for the new crate.
libs/@local/graph/embeddings/Cargo.toml	Adds the new crate to the Rust workspace with required deps.
libs/@local/graph/api/src/rest/mod.rs	Adds embedding resolution helper + embeds embedding client into REST dependencies.
libs/@local/graph/api/src/rest/entity.rs	Wires embedding client into entity search handler and resolves params asynchronously.
libs/@local/graph/api/src/rest/entity_type.rs	Wires embedding client into entity-type search handler and resolves params asynchronously.
libs/@local/graph/api/src/rest/entity_query_request.rs	Updates entity search request schema to embedding/semanticString XOR and resolves embedding server-side.
libs/@local/graph/api/package.json	Adds dependency on @rust/hash-graph-embeddings.
libs/@local/graph/api/openapi/openapi.json	Regenerates OpenAPI to reflect optional embedding and new semanticString.
libs/@local/graph/api/Cargo.toml	Adds Rust dependency on hash-graph-embeddings.
infra/compose/compose.yml	Wires HASH_GRAPH_OPENAI_API_KEY into the graph compose service.
Cargo.toml	Registers the new crate in the Rust workspace + adds reqwest-retry.
Cargo.lock	Locks new Rust dependencies (e.g. reqwest-retry, retry-policies).
apps/hash-graph/src/subcommand/server.rs	Adds HASH_GRAPH_OPENAI_API_KEY config and initializes embedding client at startup.
apps/hash-graph/package.json	Adds dependency on @rust/hash-graph-embeddings.
apps/hash-graph/Cargo.toml	Adds Rust dependency on hash-graph-embeddings.
AGENTS.md	Documents mise run sync:turborepo for Rust crate wiring changes.
.clippy.toml	Adds OpenAI to doc-valid-idents.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codspeed-hq]

Merging this PR will not alter performance

✅ 80 untouched benchmarks

---

_{Comparing t/be-622-move-semantic-search-embedding-generation-into-graph (f3b4fcf) with main (e037083)}

[Copilot]

Pull request overview

Copilot reviewed 25 out of 27 changed files in this pull request and generated 5 comments.

[codecov]

Codecov Report

❌ Patch coverage is 0% with 88 lines in your changes missing coverage. Please review.
✅ Project coverage is 59.42%. Comparing base (65a95a7) to head (f3b4fcf).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
libs/@local/graph/api/src/rest/mod.rs	0.00%	40 Missing ⚠️
libs/@local/graph/api/src/rest/entity/mod.rs	0.00%	22 Missing ⚠️
libs/@local/graph/api/src/rest/entity_type.rs	0.00%	19 Missing ⚠️
libs/@local/graph/types/src/embedding.rs	0.00%	6 Missing ⚠️
...ibs/@local/graph/sdk/typescript/src/entity-type.ts	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #8920      +/-   ##
==========================================
- Coverage   59.45%   59.42%   -0.03%     
==========================================
  Files        1358     1357       -1     
  Lines      131792   131845      +53     
  Branches     6021     6018       -3     
==========================================
- Hits        78353    78352       -1     
- Misses      52509    52563      +54     
  Partials      930      930              

Flag	Coverage Δ
apps.hash-ai-worker-ts	1.39% <ø> (ø)
apps.hash-api	6.39% <ø> (ø)
blockprotocol.type-system	40.84% <ø> (ø)
local.claude-hooks	0.00% <ø> (ø)
local.harpc-client	51.49% <ø> (ø)
local.hash-backend-utils	2.81% <ø> (ø)
local.hash-graph-sdk	10.02% <0.00%> (+0.02%)	⬆️
local.hash-isomorphic-utils	0.18% <ø> (ø)
rust.antsi	0.00% <ø> (ø)
rust.error-stack	90.89% <ø> (ø)
rust.harpc-codec	84.70% <ø> (ø)
rust.harpc-net	96.19% <ø> (ø)
rust.harpc-tower	67.03% <ø> (ø)
rust.harpc-types	0.00% <ø> (ø)
rust.harpc-wire-protocol	92.23% <ø> (ø)
rust.hash-codec	72.76% <ø> (ø)
rust.hash-graph-api	7.46% <0.00%> (-0.09%)	⬇️
rust.hash-graph-authorization	62.59% <ø> (ø)
rust.hash-graph-postgres-store	29.37% <ø> (ø)
rust.hash-graph-store	38.21% <ø> (ø)
rust.hash-graph-temporal-versioning	47.95% <ø> (ø)
rust.hash-graph-types	0.00% <0.00%> (ø)
rust.hash-graph-validation	83.43% <ø> (ø)
rust.hashql-ast	87.23% <ø> (ø)
rust.hashql-compiletest	28.40% <ø> (ø)
rust.hashql-core	79.41% <ø> (ø)
rust.hashql-diagnostics	72.31% <ø> (ø)
rust.hashql-eval	79.47% <ø> (ø)
rust.hashql-hir	89.06% <ø> (ø)
rust.hashql-mir	88.05% <ø> (ø)
rust.hashql-syntax-jexpr	94.04% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Copilot]

Pull request overview

Copilot reviewed 38 out of 40 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 37 out of 39 changed files in this pull request and generated 1 comment.

[github-actions]

Benchmark results

@rust/hash-graph-benches – Integrations

policy_resolution_large

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 2002	$$20.4 \mathrm{ms} \pm 152 \mathrm{μs}\left({\color{red}5.46 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$2.65 \mathrm{ms} \pm 11.9 \mathrm{μs}\left({\color{gray}2.39 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 1002	$$11.0 \mathrm{ms} \pm 83.7 \mathrm{μs}\left({\color{red}18.0 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 3314	$$34.4 \mathrm{ms} \pm 237 \mathrm{μs}\left({\color{gray}2.02 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$12.1 \mathrm{ms} \pm 101 \mathrm{μs}\left({\color{red}8.45 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 1527	$$19.6 \mathrm{ms} \pm 125 \mathrm{μs}\left({\color{gray}2.96 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 2078	$$20.7 \mathrm{ms} \pm 78.7 \mathrm{μs}\left({\color{gray}3.76 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$2.86 \mathrm{ms} \pm 12.2 \mathrm{μs}\left({\color{gray}0.499 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 1033	$$11.0 \mathrm{ms} \pm 77.4 \mathrm{μs}\left({\color{red}8.59 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_medium

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 102	$$2.87 \mathrm{ms} \pm 14.4 \mathrm{μs}\left({\color{gray}0.246 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$2.31 \mathrm{ms} \pm 9.20 \mathrm{μs}\left({\color{gray}0.349 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 52	$$2.60 \mathrm{ms} \pm 12.5 \mathrm{μs}\left({\color{gray}0.963 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 269	$$3.92 \mathrm{ms} \pm 15.9 \mathrm{μs}\left({\color{gray}0.556 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$2.75 \mathrm{ms} \pm 13.0 \mathrm{μs}\left({\color{gray}1.43 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 108	$$3.20 \mathrm{ms} \pm 19.7 \mathrm{μs}\left({\color{gray}1.64 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 133	$$3.34 \mathrm{ms} \pm 17.6 \mathrm{μs}\left({\color{gray}0.443 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$2.68 \mathrm{ms} \pm 16.2 \mathrm{μs}\left({\color{gray}1.91 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 63	$$3.09 \mathrm{ms} \pm 18.5 \mathrm{μs}\left({\color{gray}-0.453 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_none

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 2	$$2.11 \mathrm{ms} \pm 15.5 \mathrm{μs}\left({\color{gray}0.995 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$1.97 \mathrm{ms} \pm 9.47 \mathrm{μs}\left({\color{gray}0.783 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 2	$$2.09 \mathrm{ms} \pm 10.7 \mathrm{μs}\left({\color{gray}0.219 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 8	$$2.31 \mathrm{ms} \pm 13.4 \mathrm{μs}\left({\color{gray}1.34 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$2.14 \mathrm{ms} \pm 9.76 \mathrm{μs}\left({\color{gray}1.96 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 3	$$2.29 \mathrm{ms} \pm 10.2 \mathrm{μs}\left({\color{gray}0.696 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_small

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 52	$$2.34 \mathrm{ms} \pm 11.9 \mathrm{μs}\left({\color{gray}-0.353 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$2.15 \mathrm{ms} \pm 12.0 \mathrm{μs}\left({\color{gray}0.832 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 26	$$2.28 \mathrm{ms} \pm 14.9 \mathrm{μs}\left({\color{gray}1.73 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 94	$$2.63 \mathrm{ms} \pm 13.9 \mathrm{μs}\left({\color{gray}0.561 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$2.33 \mathrm{ms} \pm 11.5 \mathrm{μs}\left({\color{gray}2.09 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 27	$$2.53 \mathrm{ms} \pm 10.7 \mathrm{μs}\left({\color{gray}1.35 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 66	$$2.59 \mathrm{ms} \pm 12.2 \mathrm{μs}\left({\color{gray}-0.047 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$2.32 \mathrm{ms} \pm 11.1 \mathrm{μs}\left({\color{gray}0.741 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 29	$$2.50 \mathrm{ms} \pm 15.1 \mathrm{μs}\left({\color{gray}-0.171 \mathrm{\%}}\right) $$	Flame Graph

read_scaling_complete

Function	Value	Mean	Flame graphs
entity_by_id;one_depth	1 entities	$$32.9 \mathrm{ms} \pm 172 \mathrm{μs}\left({\color{gray}1.50 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	10 entities	$$25.5 \mathrm{ms} \pm 137 \mathrm{μs}\left({\color{gray}0.820 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	25 entities	$$28.5 \mathrm{ms} \pm 133 \mathrm{μs}\left({\color{gray}1.10 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	5 entities	$$25.2 \mathrm{ms} \pm 321 \mathrm{μs}\left({\color{gray}4.09 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	50 entities	$$35.8 \mathrm{ms} \pm 176 \mathrm{μs}\left({\color{red}5.94 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	1 entities	$$37.9 \mathrm{ms} \pm 244 \mathrm{μs}\left({\color{gray}-1.379 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	10 entities	$$32.4 \mathrm{ms} \pm 219 \mathrm{μs}\left({\color{gray}2.90 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	25 entities	$$72.5 \mathrm{ms} \pm 457 \mathrm{μs}\left({\color{gray}-0.005 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	5 entities	$$52.7 \mathrm{ms} \pm 4.47 \mathrm{ms}\left({\color{red}100 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	50 entities	$$240 \mathrm{ms} \pm 921 \mathrm{μs}\left({\color{red}12.8 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	1 entities	$$8.19 \mathrm{ms} \pm 35.4 \mathrm{μs}\left({\color{gray}2.24 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	10 entities	$$8.41 \mathrm{ms} \pm 60.1 \mathrm{μs}\left({\color{gray}2.10 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	25 entities	$$8.43 \mathrm{ms} \pm 47.0 \mathrm{μs}\left({\color{gray}3.54 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	5 entities	$$8.26 \mathrm{ms} \pm 58.4 \mathrm{μs}\left({\color{gray}3.46 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	50 entities	$$8.47 \mathrm{ms} \pm 54.8 \mathrm{μs}\left({\color{gray}3.62 \mathrm{\%}}\right) $$	Flame Graph

read_scaling_linkless

Function	Value	Mean	Flame graphs
entity_by_id	1 entities	$$8.11 \mathrm{ms} \pm 49.3 \mathrm{μs}\left({\color{gray}1.06 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	10 entities	$$8.21 \mathrm{ms} \pm 50.3 \mathrm{μs}\left({\color{gray}2.56 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	100 entities	$$8.36 \mathrm{ms} \pm 51.6 \mathrm{μs}\left({\color{gray}2.73 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	1000 entities	$$8.24 \mathrm{ms} \pm 40.9 \mathrm{μs}\left({\color{gray}1.25 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	10000 entities	$$8.33 \mathrm{ms} \pm 39.2 \mathrm{μs}\left({\color{gray}0.613 \mathrm{\%}}\right) $$	Flame Graph

representative_read_entity

Function	Value	Mean	Flame graphs
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/block/v/1	$$8.54 \mathrm{ms} \pm 50.7 \mathrm{μs}\left({\color{gray}2.06 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/book/v/1	$$8.53 \mathrm{ms} \pm 56.4 \mathrm{μs}\left({\color{gray}1.79 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/building/v/1	$$8.48 \mathrm{ms} \pm 61.2 \mathrm{μs}\left({\color{gray}1.31 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/organization/v/1	$$8.39 \mathrm{ms} \pm 41.4 \mathrm{μs}\left({\color{gray}1.31 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/page/v/2	$$8.38 \mathrm{ms} \pm 38.6 \mathrm{μs}\left({\color{gray}0.278 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/person/v/1	$$8.33 \mathrm{ms} \pm 49.3 \mathrm{μs}\left({\color{lightgreen}-5.658 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/playlist/v/1	$$8.54 \mathrm{ms} \pm 91.4 \mathrm{μs}\left({\color{gray}0.419 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/song/v/1	$$8.42 \mathrm{ms} \pm 47.2 \mathrm{μs}\left({\color{gray}-0.242 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/uk-address/v/1	$$8.36 \mathrm{ms} \pm 34.6 \mathrm{μs}\left({\color{gray}1.05 \mathrm{\%}}\right) $$	Flame Graph

representative_read_entity_type

Function	Value	Mean	Flame graphs
get_entity_type_by_id	Account ID: bf5a9ef5-dc3b-43cf-a291-6210c0321eba	$$6.48 \mathrm{ms} \pm 31.7 \mathrm{μs}\left({\color{gray}-0.603 \mathrm{\%}}\right) $$	Flame Graph

representative_read_multiple_entities

Function	Value	Mean	Flame graphs
entity_by_property	traversal_paths=0	0	$$47.5 \mathrm{ms} \pm 248 \mathrm{μs}\left({\color{gray}-0.040 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=255	1,resolve_depths=inherit:1;values:255;properties:255;links:127;link_dests:126;type:true	$$87.2 \mathrm{ms} \pm 467 \mathrm{μs}\left({\color{gray}-2.741 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:0;link_dests:0;type:false	$$50.5 \mathrm{ms} \pm 269 \mathrm{μs}\left({\color{gray}-2.140 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:1;link_dests:0;type:true	$$57.8 \mathrm{ms} \pm 286 \mathrm{μs}\left({\color{gray}-4.014 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:2;links:1;link_dests:0;type:true	$$66.8 \mathrm{ms} \pm 428 \mathrm{μs}\left({\color{gray}-1.137 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:2;properties:2;links:1;link_dests:0;type:true	$$70.6 \mathrm{ms} \pm 322 \mathrm{μs}\left({\color{gray}-3.561 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=0	0	$$35.6 \mathrm{ms} \pm 191 \mathrm{μs}\left({\color{gray}0.763 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=255	1,resolve_depths=inherit:1;values:255;properties:255;links:127;link_dests:126;type:true	$$58.4 \mathrm{ms} \pm 300 \mathrm{μs}\left({\color{gray}-0.181 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:0;link_dests:0;type:false	$$41.4 \mathrm{ms} \pm 170 \mathrm{μs}\left({\color{gray}4.27 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:1;link_dests:0;type:true	$$48.5 \mathrm{ms} \pm 272 \mathrm{μs}\left({\color{gray}1.01 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:2;links:1;link_dests:0;type:true	$$49.1 \mathrm{ms} \pm 259 \mathrm{μs}\left({\color{gray}-0.655 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:2;properties:2;links:1;link_dests:0;type:true	$$49.8 \mathrm{ms} \pm 247 \mathrm{μs}\left({\color{gray}0.086 \mathrm{\%}}\right) $$

scenarios

Function	Value	Mean	Flame graphs
full_test	query-limited	$$94.0 \mathrm{ms} \pm 411 \mathrm{μs}\left({\color{gray}-1.383 \mathrm{\%}}\right) $$	Flame Graph
full_test	query-unlimited	$$104 \mathrm{ms} \pm 362 \mathrm{μs}\left({\color{gray}-0.506 \mathrm{\%}}\right) $$	Flame Graph
linked_queries	query-limited	$$17.5 \mathrm{ms} \pm 237 \mathrm{μs}\left({\color{red}24.9 \mathrm{\%}}\right) $$	Flame Graph
linked_queries	query-unlimited	$$428 \mathrm{ms} \pm 626 \mathrm{μs}\left({\color{gray}2.09 \mathrm{\%}}\right) $$	Flame Graph