H-6364: Temporal wiring + ingest UI redesign by lunelson · Pull Request #8572 · hashintel/hash

lunelson · 2026-03-24T14:50:24Z

🌟 What is the purpose of this PR?

Wire the HASH frontend to the internal repo's Temporal workers and Mastra API for local dev, and redesign the ingest UI with continuous-scroll document viewer, collapsible entity cards with assertion windows, and a two-panel input layout.

🔗 Related links

H-6364 — Temporal wiring + end-to-end local dev integration test
H-6290 — End-to-end MVP atop HASH of unstructured ingest (parent)
Stacked on H-6363: Add /ingest route to HASH frontend #8566 (H-6363)
Design reference: internal/apps/agent-workflows/docs/reference/e2e-ingest-ui-design.md (internal)

🚫 Blocked by

H-6363: Add /ingest route to HASH frontend #8566 (H-6363: /ingest route scaffolding)

🔍 What does this change?

Temporal wiring:

Add Next.js rewrite for /artifacts/* to proxy page images from Mastra API
Add SSE proxy API route at /api/ingest/[runId]/events — Next.js rewrites buffer responses, breaking SSE streaming; this API route manually proxies with proper streaming headers
Internal repo changes (on branch 6357): TEMPORAL_NAMESPACE env var on TS worker, Python worker, and Mastra API Temporal client

UI redesign — document viewer:

Replace paginated PageViewer (Prev/Next buttons, single page) with continuous vertical scroll of all page images
Add per-page refs with scrollToPage via useImperativeHandle
Bbox overlay highlighting preserved, pre-computed per page via highlightedBlocksByPage map

UI redesign — results panel:

Replace flat roster + claims lists with collapsible entity cards (one per roster entry)
Expanded cards show assertion windows cross-referenced via participants[].rosterEntryId
An assertion window appears under every entity card where that entity is a participant
Falls back to roster entry summary when no assertion windows exist
New Selection types (entity | assertion) and buildEntityAssertionMap() in evidence-resolver

UI redesign — inputs view:

Two-panel layout: left = Ark UI drop zone, right = extraction mode radio toggle
Open Extraction (active) and Targeted Extraction (disabled, "Coming soon" tooltip)

Type alignment:

IngestRunView now includes mentionContexts: MentionContextPlan[]
Full MentionContextPlan discriminated union (assertion_windows | mechanical_fallback)
AssertionWindow, FallbackWindow, ContextDiagnostics types matching internal repo contracts

Pre-Merge Checklist 🚀

🚢 Has this modified a publishable library?

This PR:

does not modify any publishable blocks or libraries, or modifications do not need publishing

📜 Does this require a change to the docs?

The changes in this PR:

are in a state where docs changes are not yet required but will be

🕸️ Does this require a change to the Turbo Graph?

The changes in this PR:

do not affect the execution graph

⚠️ Known issues

Targeted extraction radio button is disabled — requires typeSelection wiring through to Temporal workflow
Assertion windows may be empty for runs from older pipeline versions (falls back to roster summary)
Local dev only — requires Mastra API + Temporal workers from internal repo with TEMPORAL_NAMESPACE=HASH

🐾 Next steps

Enable targeted extraction with ontology type selector
Show structured claim summaries (subject/predicate/object) on assertion windows
hash-api GraphQL integration (pending team discussion)
Remote deployment

🛡 What tests cover this?

turbo lint:tsc --filter=@apps/hash-frontend — type checking
yarn fix:eslint — zero lint errors
yarn fix:format — formatting clean

❓ How to test this?

Start HASH external services: yarn external-services up -d
Start graph + API + frontend: yarn start:graph, yarn dev:backend, yarn dev:frontend
Start internal repo services (from internal/apps/agent-workflows):
- TEMPORAL_NAMESPACE=HASH yarn temporal:worker:ts
- TEMPORAL_NAMESPACE=HASH yarn temporal:worker:py
- TEMPORAL_NAMESPACE=HASH yarn dev:api
Log in as alice@example.com / password
Navigate to /ingest — two-panel layout with extraction mode toggle
Upload a PDF — SSE progress streams via API route proxy
On completion, navigate to results — entity cards expand to show assertion windows
Click an entity or assertion — document viewer scrolls to relevant page with bbox highlights

📹 Demo

vercel · 2026-03-24T14:50:31Z

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

Project	Deployment	Actions	Updated (UTC)
hash	Ready	Preview, Comment	Mar 27, 2026 4:44pm

3 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
hashdotdesign	Ignored	Preview	Mar 27, 2026 4:44pm
hashdotdesign-tokens	Ignored	Preview	Mar 27, 2026 4:44pm
petrinaut	Skipped		Mar 27, 2026 4:44pm

lunelson · 2026-03-24T14:50:38Z

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

H-6364: Temporal wiring + ingest UI redesign #8572 👈 (View in Graphite)
H-6363: Add /ingest route to HASH frontend #8566
main

This stack of pull requests is managed by Graphite. Learn more about stacking.

apps/hash-frontend/src/pages/api/ingest/[runId]/events.api.ts

cursor · 2026-03-25T14:25:45Z

PR Summary

Medium Risk
Moderate risk: adds a custom SSE proxy route and changes ingest API rewrites/endpoints plus a substantial UI refactor for ingest results navigation and selection/highlighting behavior.

Overview
Wires the ingest UI to updated Mastra endpoints by updating Next.js rewrites (e.g. /api/ingest* → /ingest-runs*) and adding new artifact proxies (/api/ingest-artifacts/* and /artifacts/*). Adds a dedicated Next.js API route GET /api/ingest/[runId]/events that proxies text/event-stream responses with streaming-safe headers to avoid rewrite buffering.

Redesigns the ingest UI and results experience: the /ingest page becomes a two-panel layout with an extraction-mode selector, the results left panel becomes collapsible entity cards that show assertion windows (or claims as fallback), and evidence selection now supports assertion windows with per-entity precomputed maps.

Updates document viewing and types: replaces the paginated PageViewer with a continuous-scroll viewer exposing scrollToPage, and extends the ingest view contract to include mentionContexts (MentionContextPlan/AssertionWindow types). Also updates Temporal docker healthcheck to use temporal operator cluster health.

^{Written by Cursor Bugbot for commit 8709ff3. This will update automatically on new commits. Configure here.}

augmentcode · 2026-03-25T14:29:25Z

🤖 Augment PR Summary

Summary: Extends local ingest dev wiring to better integrate with Mastra/Temporal and redesigns the ingest UI to use continuous document scrolling and entity-centric results.

Changes:

Adds Next.js rewrites to proxy ingest artifacts, including a direct /artifacts/* path used by page image URLs.
Introduces a new /api/ingest/[runId]/events API route that proxies SSE streaming (avoiding buffering behavior of Next.js rewrites).
Updates the ingest landing page to a two-panel layout with an “Extraction Mode” radio toggle (open vs targeted/disabled).
Replaces the paginated page viewer with a continuous vertical scroll viewer that exposes an imperative scrollToPage handle.
Refactors evidence resolution to support new selection types (entity / assertion) and adds mapping from entities to assertion windows.
Redesigns the results panel into collapsible entity cards showing assertion windows (with roster-summary fallback when absent).
Aligns frontend types by adding mentionContexts and corresponding discriminated-union plan types to IngestRunView.

Technical Notes: Highlights are now computed per-page for the scroll viewer, and selection drives both bbox overlays and programmatic scrolling to relevant pages.

_{🤖 Was this summary useful? React with 👍 or 👎}

augmentcode

Review completed. 4 suggestions posted.

Comment augment review to trigger a new review at any time.

apps/hash-frontend/src/pages/api/ingest/[runId]/events.api.ts

apps/hash-frontend/src/pages/ingest.page/evidence-resolver.ts

apps/hash-frontend/src/pages/ingest.page/results-panel.tsx

apps/hash-frontend/src/pages/api/ingest/[runId]/events.api.ts

apps/hash-frontend/src/pages/ingest.page/results-panel.tsx

apps/hash-frontend/src/pages/api/ingest/[runId]/events.api.ts

apps/hash-frontend/src/pages/ingest.page/upload-panel.tsx

apps/hash-frontend/src/pages/ingest.page/page-viewer.tsx

apps/hash-frontend/src/pages/api/ingest/[runId]/events.api.ts

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

cursor · 2026-03-25T17:47:01Z

apps/hash-frontend/src/pages/ingest/results.page.tsx

          <ResultsPanel
            rosterEntries={view.roster.entries}
            claims={view.claims}
+            mentionContexts={view.mentionContexts}


Missing mentionContexts from API crashes results panel

Medium Severity

mentionContexts was added as a required field on IngestRunView, but the API response is cast with as IngestRunView without runtime validation. If the upstream API omits this field (e.g. older pipeline versions, as noted in "Known issues"), view.mentionContexts is undefined, and buildEntityAssertionMap crashes with a TypeError on the for...of loop because undefined is not iterable. A fallback like view.mentionContexts ?? [] at the call site would prevent the crash.

Additional Locations (1)

apps/hash-frontend/src/pages/ingest.page/evidence-resolver.ts#L81-L82

apps/hash-frontend/src/pages/api/ingest/[runId]/events.api.ts

+        if (done) {
+          break;
+        }
+        res.write(value);


semgrep-code-hashintel · 2026-03-27T16:07:51Z

apps/hash-frontend/src/pages/ingest.page.tsx

+      return;
+    }
+
+    void router.push(navigationAction.path);


Semgrep identified a blocking 🔴 issue in your code:
Untrusted input could be used to tamper with a web page rendering, which can lead to a Cross-site scripting (XSS) vulnerability. XSS vulnerabilities occur when untrusted input executes malicious JavaScript code, leading to issues such as account compromise and sensitive information leakage. To prevent this vulnerability, validate URLs and their protocol before using them in your codebase.

Why this might be safe to ignore:

The tainted data flows through normalizeQueryParam which restricts the value to a string and then through getIngestPageNavigationAction which constructs a safe navigation path. The router.push is using an internally constructed path rather than directly using untrusted user input.

Dataflow graph

flowchart LR classDef invis fill:white, stroke: none classDef default fill:#e7f5ff, color:#1c7fd6, stroke: none subgraph File0["<b>apps/hash-frontend/src/pages/ingest.page.tsx</b>"] direction LR %% Source subgraph Source direction LR v0["<a href=https://github.com/hashintel/hash/blob/d8d3cbf5bd5fe3e168f11ce8608db14b11a347b5/apps/hash-frontend/src/pages/ingest.page.tsx#L28 target=_blank style='text-decoration:none; color:#1c7fd6'>[Line: 28] router.query.runId</a>"] end %% Intermediate subgraph Traces0[Traces] direction TB v2["<a href=https://github.com/hashintel/hash/blob/d8d3cbf5bd5fe3e168f11ce8608db14b11a347b5/apps/hash-frontend/src/pages/ingest.page.tsx#L28 target=_blank style='text-decoration:none; color:#1c7fd6'>[Line: 28] normalizeQueryParam</a>"] v3["<a href=https://github.com/hashintel/hash/blob/d8d3cbf5bd5fe3e168f11ce8608db14b11a347b5/apps/hash-frontend/src/pages/ingest.page.tsx#L22 target=_blank style='text-decoration:none; color:#1c7fd6'>[Line: 22] value</a>"] v4["<a href=https://github.com/hashintel/hash/blob/d8d3cbf5bd5fe3e168f11ce8608db14b11a347b5/apps/hash-frontend/src/pages/ingest.page.tsx#L28 target=_blank style='text-decoration:none; color:#1c7fd6'>[Line: 28] runId</a>"] v5["<a href=https://github.com/hashintel/hash/blob/d8d3cbf5bd5fe3e168f11ce8608db14b11a347b5/apps/hash-frontend/src/pages/ingest.page.tsx#L69 target=_blank style='text-decoration:none; color:#1c7fd6'>[Line: 69] navigationAction</a>"] end v2 --> v3 v3 --> v4 v4 --> v5 %% Sink subgraph Sink direction LR v1["<a href=https://github.com/hashintel/hash/blob/d8d3cbf5bd5fe3e168f11ce8608db14b11a347b5/apps/hash-frontend/src/pages/ingest.page.tsx#L84 target=_blank style='text-decoration:none; color:#1c7fd6'>[Line: 84] navigationAction.path</a>"] end end %% Class Assignment Source:::invis Sink:::invis Traces0:::invis File0:::invis %% Connections Source --> Traces0 Traces0 --> Sink

Loading

To resolve this comment:

🔧 No guidance has been designated for this issue. Fix according to your organization's approved methods.

💬 Ignore this finding

Reply with Semgrep commands to ignore this finding.

/fp <comment> for false positive

/ar <comment> for acceptable risk

/other <comment> for all other reasons

Alternatively, triage in Semgrep AppSec Platform to ignore the finding created by react-nextjs-router-push.

_{You can view more details about this finding in the Semgrep AppSec Platform.}

apps/hash-frontend/src/pages/ingest.page.tsx

+      return;
+    }
+
+    void router.push(navigationAction.path);


github-actions bot added area/apps > hash* Affects HASH (a `hash-*` app) type/eng > frontend Owned by the @frontend team area/apps labels Mar 24, 2026

vercel bot temporarily deployed to Preview – petrinaut March 24, 2026 14:50 Inactive

lunelson mentioned this pull request Mar 24, 2026

H-6363: Add /ingest route to HASH frontend #8566

Draft

4 tasks

lunelson changed the title ~~H-6364: Add artifacts proxy rewrite for page images~~ H-6364: Temporal wiring + ingest UI redesign Mar 24, 2026

github-advanced-security bot found potential problems Mar 24, 2026

View reviewed changes

apps/hash-frontend/src/pages/api/ingest/[runId]/events.api.ts Fixed Show fixed Hide fixed

vercel bot deployed to Preview – hash March 24, 2026 15:05 View deployment

lunelson marked this pull request as ready for review March 25, 2026 14:25

vercel bot temporarily deployed to Preview – petrinaut March 25, 2026 14:25 Inactive

graphite-app bot assigned lunelson Mar 25, 2026

augmentcode bot reviewed Mar 25, 2026

View reviewed changes

cursor bot reviewed Mar 25, 2026

View reviewed changes

apps/hash-frontend/src/pages/ingest.page/evidence-resolver.ts Show resolved Hide resolved

apps/hash-frontend/src/pages/ingest.page/results-panel.tsx Outdated Show resolved Hide resolved

apps/hash-frontend/src/pages/api/ingest/[runId]/events.api.ts Outdated Show resolved Hide resolved

vercel bot deployed to Preview – hash March 25, 2026 14:33 View deployment

graphite-app bot requested a review from a team March 25, 2026 14:43

vercel bot deployed to Preview – petrinaut March 25, 2026 15:08 View deployment

cursor bot reviewed Mar 25, 2026

View reviewed changes

apps/hash-frontend/src/pages/ingest.page/results-panel.tsx Outdated Show resolved Hide resolved

vercel bot temporarily deployed to Preview – petrinaut March 25, 2026 15:13 Inactive

cursor bot reviewed Mar 25, 2026

View reviewed changes

apps/hash-frontend/src/pages/api/ingest/[runId]/events.api.ts Show resolved Hide resolved

apps/hash-frontend/src/pages/ingest.page/upload-panel.tsx Show resolved Hide resolved

apps/hash-frontend/src/pages/ingest.page/page-viewer.tsx Show resolved Hide resolved

vercel bot deployed to Preview – hash March 25, 2026 15:22 View deployment

vercel bot temporarily deployed to Preview – petrinaut March 25, 2026 15:34 Inactive

vercel bot deployed to Preview – hash March 25, 2026 15:40 View deployment

vercel bot temporarily deployed to Preview – petrinaut March 25, 2026 15:52 Inactive

lunelson force-pushed the ln/h-6364-temporal-wiring branch from ae007c6 to d7c0c10 Compare March 25, 2026 15:58

vercel bot temporarily deployed to Preview – petrinaut March 25, 2026 15:59 Inactive

vercel bot temporarily deployed to Preview – petrinaut March 25, 2026 16:03 Inactive

lunelson force-pushed the ln/h-6363-ingest-route branch from 2a4d202 to 456597a Compare March 25, 2026 17:34

vercel bot temporarily deployed to Preview – petrinaut March 25, 2026 17:34 Inactive

github-advanced-security bot found potential problems Mar 25, 2026

View reviewed changes

apps/hash-frontend/src/pages/api/ingest/[runId]/events.api.ts Fixed Show fixed Hide fixed

H-6364: Tighten SSE proxy contract

8709ff3

vercel bot temporarily deployed to Preview – petrinaut March 25, 2026 17:39 Inactive

github-advanced-security bot found potential problems Mar 25, 2026

View reviewed changes

apps/hash-frontend/src/pages/api/ingest/[runId]/events.api.ts Fixed Show fixed Hide fixed

cursor bot reviewed Mar 25, 2026

View reviewed changes

vercel bot deployed to Preview – hash March 25, 2026 17:48 View deployment

lunelson marked this pull request as draft March 26, 2026 10:30

lunelson added 4 commits March 27, 2026 13:44

feat: harden ingest recovery and claim grouping

e9aaaf6

feat: persist ingest run id in url

535ae85

feat: rehydrate ingest runs from url

e73de5e

feat: stabilize ingest progress and sidebar state

84e99b1

vercel bot temporarily deployed to Preview – petrinaut March 27, 2026 14:45 Inactive

github-actions bot added the area/deps Relates to third-party dependencies (area) label Mar 27, 2026

github-advanced-security bot found potential problems Mar 27, 2026

View reviewed changes

feat: clean up stale ingest run urls

2539f74

vercel bot temporarily deployed to Preview – petrinaut March 27, 2026 14:55 Inactive

vercel bot deployed to Preview – hash March 27, 2026 15:03 View deployment

lunelson added 4 commits March 27, 2026 16:19

feat: stabilize ingest stream handling

5b78edf

feat: narrow ingest run state variants

9c3bd2f

feat: unify ingest page navigation policy

899090d

feat: add ingest page navigation regression tests

d8d3cbf

vercel bot temporarily deployed to Preview – petrinaut March 27, 2026 16:03 Inactive

semgrep-code-hashintel bot reviewed Mar 27, 2026

View reviewed changes

vercel bot deployed to Preview – hash March 27, 2026 16:10 View deployment

feat: read ingest streams without event whitelists

188fe8d

vercel bot temporarily deployed to Preview – petrinaut March 27, 2026 16:37 Inactive

github-advanced-security bot found potential problems Mar 27, 2026

View reviewed changes

vercel bot deployed to Preview – hash March 27, 2026 16:44 View deployment

Conversation

lunelson commented Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🌟 What is the purpose of this PR?

🔗 Related links

🚫 Blocked by

🔍 What does this change?

Pre-Merge Checklist 🚀

🚢 Has this modified a publishable library?

📜 Does this require a change to the docs?

🕸️ Does this require a change to the Turbo Graph?

⚠️ Known issues

🐾 Next steps

🛡 What tests cover this?

❓ How to test this?

📹 Demo

Uh oh!

vercel bot commented Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

lunelson commented Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

cursor bot commented Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Summary

Uh oh!

augmentcode bot commented Mar 25, 2026

Uh oh!

augmentcode bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor bot Mar 25, 2026

Choose a reason for hiding this comment

Missing mentionContexts from API crashes results panel

Uh oh!

Check warning

semgrep-code-hashintel bot Mar 27, 2026

Choose a reason for hiding this comment

Uh oh!

Check warning

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

1 participant

lunelson commented Mar 24, 2026 •

edited

Loading

vercel bot commented Mar 24, 2026 •

edited

Loading

lunelson commented Mar 24, 2026 •

edited

Loading

cursor bot commented Mar 25, 2026 •

edited

Loading

Missing `mentionContexts` from API crashes results panel