Skip to content

✨ ScoutNext: curated home feed + conversation loading; Knowledge search (SCO-062)#199

Merged
arach merged 3 commits into
mainfrom
feat/in-app-session-initiation
Jun 5, 2026
Merged

✨ ScoutNext: curated home feed + conversation loading; Knowledge search (SCO-062)#199
arach merged 3 commits into
mainfrom
feat/in-app-session-initiation

Conversation

@arach
Copy link
Copy Markdown
Owner

@arach arach commented Jun 5, 2026

Two independent bodies of work on this branch.

1. ScoutNext mobile + bridge (0beb4b0f)

Fixes the mobile Home feed and conversation loading, plus in-app comms surfaces.

Home activity feed — curated, not the firehose. The Home tab was reading the raw /v1/activity lifecycle firehose (ask_opened, flight_updated, invocation_recorded…) and substring-guessing roles, which produced meaningless other tokens, inverted attribution, and duplicate/inert rows. It now reads the broker's curated home feed (/v1/home): one row per message, named actors, accurate user/assistant roles, every row thread-linked. The raw firehose stays where it belongs — the Tail tab. (Home is an orientation surface; it reads curated sources.)

Conversations wouldn't load. A pre-existing bug: the bridge router blindly wrapped every routed id into dm.operator.{id}, which only resolved for agents that happen to have an operator DM. Agents whose history lives in a c.… conversation (and Home-activity taps carrying real c.… ids) all 404'd with Unknown mobile session. Resolution now happens in the snapshot service against the live broker snapshot: direct hit → operator DM → most-recent participating conversation. Validated against live data across bare agent ids, c.…, dm.…, and unknown ids.

Transcript states. The conversation view now has explicit loading / empty / failed (with retry) states, so an empty session reads as intentional rather than a black void.

Misc. RECENT agents list collapses to single-line rows (project shown only when on a branch); in-app comms mark-read via a broker read-cursor RPC + bridge connection surfaces.

2. Knowledge search + context index — SCO-062 (d704f2df)

  • Runtime knowledge module (@openscout/runtime/knowledge): QMD store, session indexer, path resolution, types + tests
  • Knowledge search screen + inspector slot, search-route right-panel sizing, KnowledgeHit state on the scout Provider
  • Session knowledge indexing wired into the web server
  • SCO-062 design doc, review notes, studio search-results study

Validation

  • ScoutNext target builds for the simulator; installed + launched on iPhone 17 Pro Max.
  • Curated Home feed confirmed live (named actors, accurate roles, no other, no duplicates).
  • Conversation resolver validated against the live broker snapshot for every id form the phone sends.
  • Web server change typechecks clean (pre-existing tsc noise in the web package is unrelated).
  • Bridge bundle rebuilt + supervisor respawned to ship the TS changes end-to-end.

Note on commit structure

These two features were committed separately, but the ScoutNext changes had to be one commit: the session's fixes were interleaved line-by-line with pre-existing uncommitted ScoutNext-surface work (comms mark-read, activity-row tap affordance) inside the same hunks of shared files, so a finer split wasn't cleanly possible.

arach added 2 commits June 5, 2026 13:47
- Home activity now reads the broker's curated home feed (named actors,
  accurate user/assistant roles, one row per message) instead of the raw
  /v1/activity lifecycle firehose; the firehose stays on the Tail tab
- Resolve mobile conversation snapshots against the live broker snapshot —
  real c.* / dm.* conversation ids and bare agent ids all map to their
  actual conversation, fixing transcripts that silently wouldn't load
- Conversation transcript gains loading / empty / failed states with retry,
  so an empty session reads as intentional instead of a black void
- RECENT agents list collapses to single-line rows (project only when on a branch)
- In-app comms mark-read via a broker read-cursor RPC + bridge surfaces
- Runtime knowledge module (@openscout/runtime/knowledge): QMD store,
  session indexer, path resolution, types + tests
- Knowledge search screen + inspector slot, search-route right-panel sizing,
  and KnowledgeHit state on the scout Provider
- Session knowledge indexing wired into the web server
- SCO-062 design doc, review notes, and studio search-results study
@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 5, 2026

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

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
openscout Skipped Skipped Jun 5, 2026 5:58pm

@arach arach merged commit 0d3c128 into main Jun 5, 2026
3 checks passed
@arach arach deleted the feat/in-app-session-initiation branch June 5, 2026 18:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant