Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
b616cf3
docs(spec): thread sidebar design for React and Angular
blove Nov 17, 2026
e435d2f
docs(plan): thread sidebar phase 1 implementation plan
blove Nov 17, 2026
9240589
feat(core): add the ThreadDirectory contract
blove Nov 17, 2026
c87626e
feat(langgraph): add a framework-neutral LangGraph thread directory
blove Nov 17, 2026
0d018f6
feat(langgraph): store project names with the LangGraph Store API
blove Nov 17, 2026
0c4f79e
feat(chat): add the ThreadDirectory contract for Angular
blove Nov 17, 2026
eea4ea1
feat(langgraph): expose LangGraphThreadsAdapter as a ThreadDirectory …
blove Nov 17, 2026
5504913
fix(langgraph): publish threads before loading project names
blove Nov 17, 2026
ec8298d
feat(react): add a connected ThreadSidebar
blove Nov 17, 2026
764e117
feat(chat): add a connected chat-thread-sidebar
blove Nov 17, 2026
d9be395
test(cockpit): drive the threads examples through the connected sidebars
blove Nov 17, 2026
455208e
test(cockpit): keep the threads examples' guarantees under the connec…
blove Nov 17, 2026
30a6cf1
docs: document the connected thread sidebars
blove Nov 17, 2026
c4abb5d
fix(threads): hide unavailable projects, filter by project, settle fi…
blove Nov 17, 2026
2706562
test(cockpit): select projects in the threads examples and allow side…
blove Nov 17, 2026
9db876b
docs: describe project selection, unavailable projects and the React …
blove Nov 17, 2026
6f7670b
fix(threads): clear a deleted project from the sidebar selection
blove Nov 17, 2026
e709067
Merge remote-tracking branch 'origin/main' into blove/thread-sidebar-…
blove Nov 17, 2026
e4e3443
test(core): check the run-end refresh handles rejection without node …
blove Nov 17, 2026
5b821d4
test(smoke): allow the adapter's project-name read in the packaged co…
blove Nov 17, 2026
50f4549
Merge remote-tracking branch 'origin/main' into blove/thread-sidebar-…
blove Nov 18, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion apps/website/content/AGENTS.md.template
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Chat Debug has an experimental native React first slice at https://threadplane.a

Chat Timeline has an experimental native React preview at https://threadplane.ai/docs/react/chat/components/chat-trace. The first Send creates a conversation lazily; New is local and inert until Send. Refresh checkpoints explicitly requests the recent page with limit 10 and clears selection; successful turns do not refresh it automatically. Selecting a completed root checkpoint loads a separate read-only preview of this graph's strict plain alternating human/assistant transcript. In-progress or invalid checkpoint references are unavailable. Unsupported saved transcripts fail preview validation. Ordinary Send continues the current conversation and retains the validated preview without consuming the draft on selection. Fork from here uses the selected checkpoint and current draft: after A+B, preview A and Send C gives A+B+C; Fork D gives A+D; after confirmation the fork becomes current, the preview clears, and Send E gives A+D+E. Failed or cancelled reads leave the primary conversation usable. Stop or uncertain execution requires New, with no replay, retry or resume. One configured target and header owner serves creation, streams and reads with retries disabled, using the existing shared FREE c-timeline graph. Docs, Code and Run use the same native React implementation; mode navigation preserves the mounted frame and draft, and reload clears local state. Mount and mode changes make no thread requests. Angular remains the default; its Replay/Fork events require host wiring. Candidate packages remain private source builds. Build with `npx nx build cockpit-chat-timeline-react` and verify with `npx nx e2e cockpit-chat-timeline-react`.

Chat Threads has an experimental native React preview at https://threadplane.ai/docs/react/chat/guides/thread-routing. It composes MessageList, Markdown, Reasoning, Citations and ChatInput with the existing c-threads graph. The picker and per-conversation drafts last only while the page stays open. Send creates a confirmed thread lazily; selection creates a fresh session fixed to that known identity and checks the exact retained canonical transcript and terminal checkpoint before enabling a follow-up. Every successful turn also requires saved-history confirmation. Optional titles are literal text bounded to 80 Unicode code points; missing or invalid metadata preserves the fallback or last valid title, and stale title requests cannot affect another selection. Titles never authorize execution. Stop and cleanup detach the owner, prevent late responses from restoring commands, and leave uncertain records unavailable while other confirmed conversations remain usable. There is no shared search, arbitrary-ID loading, URL routing, rename/delete management, retry, replay or resume. Runtime settings select one target for creation, streams, saved history and optional titles, with retries disabled. Mount and mode changes cause no thread requests; Docs, Code and Run select the same React implementation. Angular remains the default, the shared deployment is reused, and candidate packages remain private source builds. Build with `npx nx build cockpit-chat-threads-react` and verify with `npx nx e2e cockpit-chat-threads-react`.
Chat Threads has an experimental native React preview at https://threadplane.ai/docs/react/chat/guides/thread-routing. It composes the connected ThreadSidebar with MessageList, Markdown, Reasoning, Citations and ChatInput over the existing c-threads graph. The sidebar lists the threads saved on the server through a directory from createLangGraphThreadDirectory and offers rename, pin, drag reordering, archive, delete and projects; project names are kept in the LangGraph Store under the namespace ['threadplane', 'projects'], and selecting a project lists only its conversations until it is selected again. Only conversations created and confirmed on the open page can be continued; choosing a listed conversation from an earlier visit shows a notice instead of loading it. Per-conversation drafts last only while the page stays open. Send creates a confirmed thread lazily; selection creates a fresh session fixed to that known identity and checks the exact retained canonical transcript and terminal checkpoint before enabling a follow-up. Every successful turn also requires saved-history confirmation. Titles are optional server metadata written by the graph; the sidebar shows a fallback when a title is missing, and titles never authorize execution. Stop and cleanup detach the owner, prevent late responses from restoring commands, and leave uncertain records unavailable while other confirmed conversations remain usable. There is no arbitrary-ID loading, URL routing, retry, replay or resume. Runtime settings select one target for creation, streams, saved history and the sidebar's thread and Store requests, with retries disabled. On mount the sidebar makes read-only thread and Store searches; mount and mode changes create no threads and start no runs. Docs, Code and Run select the same React implementation. Angular remains the default, the shared deployment is reused, and candidate packages remain private source builds. Build with `npx nx build cockpit-chat-threads-react` and verify with `npx nx e2e cockpit-chat-threads-react`.

Chat Subagents has an experimental native React preview at https://threadplane.ai/docs/react/chat/components/chat-subagent-card. It uses the existing c-subagents graph with research, booking and itinerary specialists to provide model-generated planning suggestions, without live availability/prices or actual booking. Saved root task calls and literal results stay with the requesting assistant. A separate default-closed Child response observations disclosure retains validated child text locally across root history loads and follow-up turns; these rows are not restored execution history and are not mapped to task cards. Full namespaces identify local observations internally; no parent binding is inferred from role, order or task arguments. Valid empty child text adds no row. Stop and incomplete work label retained observations accordingly, without claiming child execution success. Child errors, interruptions, tools, malformed supplied values, changed completed text and foreign generations permanently withhold continuation for that owner, even if later history clears child snapshots. Only matching terminal saved root evidence permits a follow-up; a fulfilled aborted load does not. New clears local state without remote deletion. Mount, draft seeds and local reset cause no runtime request. Title generation remains metadata-only, the existing shared deployment is reused, Angular remains the default, and candidate packages remain private source builds.

Expand Down
2 changes: 1 addition & 1 deletion apps/website/content/CLAUDE.md.template
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Chat Debug has an experimental native React first slice at https://threadplane.a

Chat Timeline has an experimental native React preview at https://threadplane.ai/docs/react/chat/components/chat-trace. The first Send creates a conversation lazily; New is local and inert until Send. Refresh checkpoints explicitly requests the recent page with limit 10 and clears selection; successful turns do not refresh it automatically. Selecting a completed root checkpoint loads a separate read-only preview of this graph's strict plain alternating human/assistant transcript. In-progress or invalid checkpoint references are unavailable. Unsupported saved transcripts fail preview validation. Ordinary Send continues the current conversation and retains the validated preview without consuming the draft on selection. Fork from here uses the selected checkpoint and current draft: after A+B, preview A and Send C gives A+B+C; Fork D gives A+D; after confirmation the fork becomes current, the preview clears, and Send E gives A+D+E. Failed or cancelled reads leave the primary conversation usable. Stop or uncertain execution requires New, with no replay, retry or resume. One configured target and header owner serves creation, streams and reads with retries disabled, using the existing shared FREE c-timeline graph. Docs, Code and Run use the same native React implementation; mode navigation preserves the mounted frame and draft, and reload clears local state. Mount and mode changes make no thread requests. Angular remains the default; its Replay/Fork events require host wiring. Candidate packages remain private source builds. Build with `npx nx build cockpit-chat-timeline-react` and verify with `npx nx e2e cockpit-chat-timeline-react`.

Chat Threads has an experimental native React preview at https://threadplane.ai/docs/react/chat/guides/thread-routing. It composes MessageList, Markdown, Reasoning, Citations and ChatInput with the existing c-threads graph. The picker and per-conversation drafts last only while the page stays open. Send creates a confirmed thread lazily; selection creates a fresh session fixed to that known identity and checks the exact retained canonical transcript and terminal checkpoint before enabling a follow-up. Every successful turn also requires saved-history confirmation. Optional titles are literal text bounded to 80 Unicode code points; missing or invalid metadata preserves the fallback or last valid title, and stale title requests cannot affect another selection. Titles never authorize execution. Stop and cleanup detach the owner, prevent late responses from restoring commands, and leave uncertain records unavailable while other confirmed conversations remain usable. There is no shared search, arbitrary-ID loading, URL routing, rename/delete management, retry, replay or resume. Runtime settings select one target for creation, streams, saved history and optional titles, with retries disabled. Mount and mode changes cause no thread requests; Docs, Code and Run select the same React implementation. Angular remains the default, the shared deployment is reused, and candidate packages remain private source builds. Build with `npx nx build cockpit-chat-threads-react` and verify with `npx nx e2e cockpit-chat-threads-react`.
Chat Threads has an experimental native React preview at https://threadplane.ai/docs/react/chat/guides/thread-routing. It composes the connected ThreadSidebar with MessageList, Markdown, Reasoning, Citations and ChatInput over the existing c-threads graph. The sidebar lists the threads saved on the server through a directory from createLangGraphThreadDirectory and offers rename, pin, drag reordering, archive, delete and projects; project names are kept in the LangGraph Store under the namespace ['threadplane', 'projects'], and selecting a project lists only its conversations until it is selected again. Only conversations created and confirmed on the open page can be continued; choosing a listed conversation from an earlier visit shows a notice instead of loading it. Per-conversation drafts last only while the page stays open. Send creates a confirmed thread lazily; selection creates a fresh session fixed to that known identity and checks the exact retained canonical transcript and terminal checkpoint before enabling a follow-up. Every successful turn also requires saved-history confirmation. Titles are optional server metadata written by the graph; the sidebar shows a fallback when a title is missing, and titles never authorize execution. Stop and cleanup detach the owner, prevent late responses from restoring commands, and leave uncertain records unavailable while other confirmed conversations remain usable. There is no arbitrary-ID loading, URL routing, retry, replay or resume. Runtime settings select one target for creation, streams, saved history and the sidebar's thread and Store requests, with retries disabled. On mount the sidebar makes read-only thread and Store searches; mount and mode changes create no threads and start no runs. Docs, Code and Run select the same React implementation. Angular remains the default, the shared deployment is reused, and candidate packages remain private source builds. Build with `npx nx build cockpit-chat-threads-react` and verify with `npx nx e2e cockpit-chat-threads-react`.

Chat Subagents has an experimental native React preview at https://threadplane.ai/docs/react/chat/components/chat-subagent-card. It uses the existing c-subagents graph with research, booking and itinerary specialists to provide model-generated planning suggestions, without live availability/prices or actual booking. Saved root task calls and literal results stay with the requesting assistant. A separate default-closed Child response observations disclosure retains validated child text locally across root history loads and follow-up turns; these rows are not restored execution history and are not mapped to task cards. Full namespaces identify local observations internally; no parent binding is inferred from role, order or task arguments. Valid empty child text adds no row. Stop and incomplete work label retained observations accordingly, without claiming child execution success. Child errors, interruptions, tools, malformed supplied values, changed completed text and foreign generations permanently withhold continuation for that owner, even if later history clears child snapshots. Only matching terminal saved root evidence permits a follow-up; a fulfilled aborted load does not. New clears local state without remote deletion. Mount, draft seeds and local reset cause no runtime request. Title generation remains metadata-only, the existing shared deployment is reused, Angular remains the default, and candidate packages remain private source builds.

Expand Down
Loading
Loading