feat: include source page link in chat responses by HardeepAsrani · Pull Request #180 · Codeinwp/hyve-lite

HardeepAsrani · 2026-06-30T23:15:57Z

The Pro companion is Codeinwp/hyve#236.
Closes: https://github.com/Codeinwp/hyve/issues/152

What this adds

When Hyve answers a question, it can now show where the answer came from — the knowledge base content it drew on — as small numbered citations under the reply.

Highlights:

Off by default. Turn it on under Settings → General → “Show Source Link in Chat Responses.”
Numbered citations. Sources appear as a compact Sources 1 2 3 row beneath the answer; hovering (or focusing) a number reveals the page title, and clicking opens it in a new tab.
Only what’s relevant. Sources are ranked by how well they match the question, and weak stragglers are dropped — so a question that’s really about one page shows one source, not three padded ones. At most three are shown.
Only what’s public. A link is added only for publicly accessible content. Private posts, password-protected posts, and content with no public URL (e.g. custom data) are never linked.
Theme-aware. The label and numbers follow the chat’s text color, so they stay legible on both light and custom/dark chat backgrounds.
Works with both the streaming and non-streaming reply flows.

For developers

Three filters are available for fine-tuning:

hyve_source_link_limit — max number of sources shown (default 3).
hyve_source_link_score_ratio — how close to the best match a source must score to be shown, as a ratio of the top score (default 0.8; 0 shows everything above the relevance threshold).
hyve_chat_source_link — resolve/override the URL for a given source (used by the Pro plugin for website-link and sitemap sources, and to suppress links for custom data).

Base branch is feat/streaming-responses and this builds on #179 (it reuses the post-visibility helper for the public-accessibility check).

Manual QA

Prerequisite: add a few public Posts/Pages to the Knowledge Base and make sure the chat answers from them.

Enable the setting. Go to Settings → General, set “Show Source Link in Chat Responses” to Enable, and save.
Ask a grounded question. Ask something clearly covered by one of your KB pages. Under the answer you should see a “Sources” label followed by numbered chips.
- Hover/focus a number → the page title appears as a tooltip.
- Click a number → the source page opens in a new tab.
Relevance. Ask a question that only one page really covers → you should see just that one source, not three. Ask a broad question covered by several pages → you should see up to three.
Public-only.
- Set a KB source Post to Private (or add a password), ask a question it would answer → that page must not be linked.
- Confirm no link is shown for sources that have no public URL.
Both reply modes. Repeat step 2 with streaming responses on and off — citations should appear in both.
Theming. Under Settings → Appearance, set a dark chat/assistant background → the “Sources” label and numbers should remain readable (they switch to a light color); hover fill uses the accent color.
Off state. Set the setting back to Disable and save → answers should no longer show any source citations.
No sources case. Ask an off-topic question the KB can’t answer → no “Sources” row should appear.

With the Pro plugin (Codeinwp/hyve#236) active, also confirm: website-link and sitemap sources link to their original public URL, and custom-data sources show no link.

- Redesign the frontend chat widget (header with avatar/name/status, modern bubbles, pill input, refined launcher, entrance animation). - Add a global "Chat Sound" toggle and a per-visitor mute control in the chat menu; remove the open/close click sound. - Add a "Message Timestamp" show/hide toggle. - Show the welcome message and suggested questions on first load of the inline chat block. - Inline the chat-button SVGs server-side (no runtime fetch / icon flash) and use a bundled SVG as the default icon instead of an emoji. - Keep the typing dots, suggestion chips, and menu legible on similar colors, and theme the menu from the chat colors. - Resolve outstanding PHPStan issues (gmdate guard, require_once ignore).

Reveal the assistant's reply progressively over Server-Sent Events, with a graceful fallback to the existing background + polling flow on hosts that buffer or cannot stream, so the bot keeps working everywhere. - Add a custom admin-ajax streaming endpoint (Stream) that proxies OpenAI's stream to the browser; the API key stays server-side. - Share a single prompt, JSON schema and response interpreter across the streaming and poll paths so replies never diverge by transport. - The widget tries streaming first and falls back to polling when no event arrives in time; the outcome is cached per browser and re-probed after 24h. - Decode the streamed `response` field incrementally via json_decode so escapes and surrogate-pair emoji render correctly while streaming. - Preserve existing contracts: moderation stays up front, hyve_chat_request and hyve_chat_response fire once per reply, analytics unaffected. Closes Codeinwp/hyve#183

… Base Private posts were excluded from the Add Data list because the listing and re-index queries filtered to the 'publish' status only. Include the 'private' status so private posts can be added and stay in sync when edited. (Password-protected posts already matched 'publish' and were addable.) Because added content is surfaced to any chat visitor regardless of the post's original visibility, adding a private or password-protected post now requires an explicit confirmation.

Append a compact source citation to chat answers, shown only for publicly accessible sources. Adds a Settings toggle and a hyve_chat_source_link filter for source-type-specific resolution.

- Redesign the frontend chat widget (header with avatar/name/status, modern bubbles, pill input, refined launcher, entrance animation). - Add a global "Chat Sound" toggle and a per-visitor mute control in the chat menu; remove the open/close click sound. - Add a "Message Timestamp" show/hide toggle. - Show the welcome message and suggested questions on first load of the inline chat block. - Inline the chat-button SVGs server-side (no runtime fetch / icon flash) and use a bundled SVG as the default icon instead of an emoji. - Keep the typing dots, suggestion chips, and menu legible on similar colors, and theme the menu from the chat colors. - Resolve outstanding PHPStan issues (gmdate guard, require_once ignore).

# Conflicts: # inc/Main.php # src/frontend/App.js Co-authored-by: HardeepAsrani <2649903+HardeepAsrani@users.noreply.github.com>

github-actions · 2026-07-03T20:03:14Z

Plugin build for 219d69e is ready 🛎️!

Download Plugin - Download

…g-responses Co-authored-by: HardeepAsrani <2649903+HardeepAsrani@users.noreply.github.com>

HardeepAsrani · 2026-07-03T20:11:51Z

@copilot resolve the merge conflicts in this pull request

Co-authored-by: HardeepAsrani <2649903+HardeepAsrani@users.noreply.github.com>

Copilot · 2026-07-03T20:17:30Z

@copilot resolve the merge conflicts in this pull request

Fixed in 7cf3c51.

HardeepAsrani · 2026-07-03T20:31:15Z

@copilot resolve the merge conflicts in this pull request

Co-authored-by: HardeepAsrani <2649903+HardeepAsrani@users.noreply.github.com>

Copilot · 2026-07-03T20:37:43Z

@copilot resolve the merge conflicts in this pull request

Fixed in d6ea24c.

HardeepAsrani · 2026-07-08T20:44:29Z

@copilot resolve the merge conflicts in this pull request

Co-authored-by: HardeepAsrani <2649903+HardeepAsrani@users.noreply.github.com>

Copilot · 2026-07-08T20:51:13Z

@copilot resolve the merge conflicts in this pull request

Fixed in e7c89b4.

HardeepAsrani · 2026-07-08T21:02:59Z

@codex[agent] Fix the PHPStan/lint errors.

Agent-Logs-Url: https://github.com/Codeinwp/hyve-lite/sessions/da19ee32-5f21-4b9c-9cb2-49c699cee9cf Co-authored-by: HardeepAsrani <2649903+HardeepAsrani@users.noreply.github.com>

Codex · 2026-07-08T21:08:24Z

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

openaipublic.blob.core.windows.net
- Triggering command: /usr/bin/php php /home/REDACTED/work/hyve-lite/hyve-lite/vendor/bin/phpunit (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot cloud agent settings (admins only)

HardeepAsrani and others added 6 commits June 29, 2026 06:42

feat: prototype source link in chat responses

89729d1

Append a compact source citation to chat answers, shown only for publicly accessible sources. Adds a Settings toggle and a hyve_chat_source_link filter for source-type-specific resolution.

Merge remote-tracking branch 'origin/development' into feat/various

0d47983

# Conflicts: # inc/Main.php # src/frontend/App.js Co-authored-by: HardeepAsrani <2649903+HardeepAsrani@users.noreply.github.com>

HardeepAsrani marked this pull request as ready for review July 3, 2026 20:01

HardeepAsrani changed the base branch from feat/private-password-kb-content to development July 3, 2026 20:04

Merge remote-tracking branch 'origin/feat/various' into feat/streamin…

f6d86fb

…g-responses Co-authored-by: HardeepAsrani <2649903+HardeepAsrani@users.noreply.github.com>

Copilot started work on behalf of HardeepAsrani July 3, 2026 20:12 View session

Merge branch 'development' into feat/chat-source-link

7cf3c51

Co-authored-by: HardeepAsrani <2649903+HardeepAsrani@users.noreply.github.com>

Copilot finished work on behalf of HardeepAsrani July 3, 2026 20:17

HardeepAsrani changed the base branch from development to feat/streaming-responses July 3, 2026 20:30

Copilot started work on behalf of HardeepAsrani July 3, 2026 20:31 View session

Merge branch 'feat/streaming-responses' into feat/chat-source-link

d6ea24c

Co-authored-by: HardeepAsrani <2649903+HardeepAsrani@users.noreply.github.com>

Copilot finished work on behalf of HardeepAsrani July 3, 2026 20:37

feat: show up to three relevance-ranked sources as numbered citations

8a3118e

HardeepAsrani requested a review from Soare-Robert-Daniel July 3, 2026 22:01

Soare-Robert-Daniel approved these changes Jul 6, 2026

View reviewed changes

HardeepAsrani changed the base branch from feat/streaming-responses to development July 8, 2026 20:44

Copilot started work on behalf of HardeepAsrani July 8, 2026 20:45 View session

Merge branch 'development' into feat/chat-source-link

e7c89b4

Co-authored-by: HardeepAsrani <2649903+HardeepAsrani@users.noreply.github.com>

Copilot finished work on behalf of HardeepAsrani July 8, 2026 20:51

Codex started work on behalf of HardeepAsrani July 8, 2026 21:03 View session

fix: remove duplicate settings validators causing PHPStan/PHPCS failures

219d69e

Agent-Logs-Url: https://github.com/Codeinwp/hyve-lite/sessions/da19ee32-5f21-4b9c-9cb2-49c699cee9cf Co-authored-by: HardeepAsrani <2649903+HardeepAsrani@users.noreply.github.com>

Codex finished work on behalf of HardeepAsrani July 8, 2026 21:08

HardeepAsrani merged commit de49754 into development Jul 8, 2026
7 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: include source page link in chat responses - #180

feat: include source page link in chat responses#180
HardeepAsrani merged 12 commits into
developmentfrom
feat/chat-source-link

HardeepAsrani commented Jun 30, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 3, 2026 •

edited

Loading

Uh oh!

HardeepAsrani commented Jul 3, 2026

Uh oh!

Copilot AI commented Jul 3, 2026

Uh oh!

HardeepAsrani commented Jul 3, 2026

Uh oh!

Copilot AI commented Jul 3, 2026

Uh oh!

HardeepAsrani commented Jul 8, 2026

Uh oh!

Copilot AI commented Jul 8, 2026

Uh oh!

HardeepAsrani commented Jul 8, 2026

Uh oh!

Codex AI commented Jul 8, 2026

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

HardeepAsrani commented Jun 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What this adds

For developers

Manual QA

Uh oh!

github-actions Bot commented Jul 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

HardeepAsrani commented Jul 3, 2026

Uh oh!

Copilot AI commented Jul 3, 2026

Uh oh!

HardeepAsrani commented Jul 3, 2026

Uh oh!

Copilot AI commented Jul 3, 2026

Uh oh!

HardeepAsrani commented Jul 8, 2026

Uh oh!

Copilot AI commented Jul 8, 2026

Uh oh!

HardeepAsrani commented Jul 8, 2026

Uh oh!

Codex AI commented Jul 8, 2026

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

HardeepAsrani commented Jun 30, 2026 •

edited

Loading

github-actions Bot commented Jul 3, 2026 •

edited

Loading