> For the complete documentation index, see [llms.txt](https://faction-os.gitbook.io/faction-os-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://faction-os.gitbook.io/faction-os-docs/.spec_system/archive/sessions/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md). # Implementation Notes **Session ID**: `phase17-session07-war-room-worker-relay-and-catchup` **Package**: Cross-package (`packages/protocol`, `apps/warroom`) **Started**: 2026-06-05 22:38 **Last Updated**: 2026-06-05 22:38 *** ## Session Progress | Metric | Value | | ------------------- | ------- | | Tasks Completed | 22 / 22 | | Estimated Remaining | 0 hours | | Blockers | 0 | *** ## Task Log ### 2026-06-05 - Session Start **Environment verified**: * [x] Prerequisites confirmed * [x] Tools available * [x] Directory structure ready *** ### Task T001 - Review protocol War Room frame validation **Started**: 2026-06-05 22:38 **Completed**: 2026-06-05 22:38 **Duration**: 1 minutes **Notes**: * Reviewed `WAR_ROOM_SAFE_FRAME_TYPE_VALUES`, `parseWarRoomSocketFrame`, `parseWarRoomRecentEvent`, `parseWarRoomCatchupFrame`, `filterSafeWarRoomRecentEvents`, summaries, and blocked key/value scanning. * Confirmed Notice Board relay needs protocol-owned additions before Worker persistence and broadcast. **Files Changed**: * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T001 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged review completion. **BQC Fixes**: * N/A - review task. *** ### Task T002 - Review Worker socket handling and persistence **Started**: 2026-06-05 22:38 **Completed**: 2026-06-05 22:39 **Duration**: 1 minutes **Notes**: * Reviewed Durable Object hydration, persistence, `handleSocket`, `handleClientMessage`, `broadcast`, `sendFrame`, and `safeRecentEvents`. * Confirmed existing behavior persists bounded legacy safe frames, sends `warroom_pending_catchup`, and sender-excludes `remote_event` broadcasts. **Files Changed**: * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T002 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged review completion. **BQC Fixes**: * N/A - review task. *** ### Task T003 - Review Worker test harness **Started**: 2026-06-05 22:39 **Completed**: 2026-06-05 22:39 **Duration**: 1 minutes **Notes**: * Reviewed fake storage, fake WebSocket pair, socket opener, authority capture, and persisted history assertions in `apps/warroom/tests/warroom.test.ts`. * Confirmed focused relay tests can reuse the same in-file helper style without new dependencies. **Files Changed**: * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T003 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged review completion. **BQC Fixes**: * N/A - review task. *** ### Task T004 - Add protocol Notice Board frame vocabulary **Started**: 2026-06-05 22:39 **Completed**: 2026-06-05 22:45 **Duration**: 6 minutes **Notes**: * Added `notice_board_message` and `notice_resolved` to the Worker-safe socket/federation frame vocabulary. * Added typed `notice_board_catchup` server frame support and family labels for summary output. * Ran `npm --workspace packages/protocol run typecheck`. **Files Changed**: * `packages/protocol/src/warroom.ts` - extended frame constants, type unions, server socket union, and labels. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T004 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged protocol vocabulary work. **BQC Fixes**: * Contract alignment: added typed unions before Worker behavior to avoid untyped cross-package frame drift. *** ### Task T005 - Define Notice Board message frame validation **Started**: 2026-06-05 22:39 **Completed**: 2026-06-05 22:45 **Duration**: 6 minutes **Notes**: * Added `notice_board_message` parsing through canonical Notice Board alias normalization. * Added strict notice field allowlisting, safe id normalization, bounded author metadata, timestamp handling, and blocked key/value rejection. * Broadcast payload output normalizes `message` to the sanitized `notice` payload to avoid alias divergence. **Files Changed**: * `packages/protocol/src/warroom.ts` - added message frame contract and safe notice normalization helpers. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T005 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged message contract work. **BQC Fixes**: * Trust boundary enforcement: socket Notice Board payloads are schema-normalized and blocked-field scanned before persistence or broadcast. * Contract alignment: `notice` and `message` aliases are normalized to the same safe payload. *** ### Task T006 - Define Notice Board resolution frame validation **Started**: 2026-06-05 22:39 **Completed**: 2026-06-05 22:45 **Duration**: 6 minutes **Notes**: * Added `notice_resolved` parser support with `noticeId`/`messageId` alias normalization. * Bounded optional `resolution`, `resolvedAt`, `roomCode`, and embedded notice/message payloads. * Mapped malformed Notice Board metadata into compact `invalid_socket_frame` or `blocked_frame_field` envelopes. **Files Changed**: * `packages/protocol/src/warroom.ts` - added resolution frame contract and bounded metadata readers. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T006 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged resolution contract work. **BQC Fixes**: * Error information boundaries: resolution validation returns compact field-level errors without raw payload echo. * Contract alignment: `messageId` must match `noticeId` when present. *** ### Task T007 - Define Notice Board catch-up validation **Started**: 2026-06-05 22:39 **Completed**: 2026-06-05 22:45 **Duration**: 6 minutes **Notes**: * Added `parseWarRoomNoticeBoardCatchupFrame` for bounded `notice_board_catchup` arrays. * Validates every notice entry through the same sanitized Notice Board relay parser. * Sorts catch-up notices by created/post time and id for deterministic reconnect order. **Files Changed**: * `packages/protocol/src/warroom.ts` - added catch-up frame parser and notice array ordering helper. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T007 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged catch-up contract work. **BQC Fixes**: * State freshness on re-entry: reconnect catch-up payloads are revalidated and deterministically ordered before use. *** ### Task T008 - Extend safe recent-event filtering and summaries **Started**: 2026-06-05 22:39 **Completed**: 2026-06-05 22:45 **Duration**: 6 minutes **Notes**: * Extended `WarRoomSafeClientFrame` and federation labels so safe recent-event parsing accepts Notice Board relay families. * Added safe Notice Board notice filtering for Worker relay history. * Summary labels report family counts only, not notice ids, content, resolution text, or embedded payload details. **Files Changed**: * `packages/protocol/src/warroom.ts` - extended recent-event frame families and added safe notice filtering. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T008 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged filtering and summary work. **BQC Fixes**: * Error information boundaries: summaries expose only safe family labels and counts. *** ### Task T009 - Create focused protocol relay test scaffold **Started**: 2026-06-05 22:45 **Completed**: 2026-06-05 22:49 **Duration**: 4 minutes **Notes**: * Added focused protocol tests for relay frame constants, parser success, malformed input, unknown fields, blocked values, catch-up bounds, and safe filtering. * Updated the existing War Room protocol constants test for the expanded safe frame vocabulary. * Ran `npx vitest run packages/protocol/tests/warroomNoticeRelay.test.ts packages/protocol/tests/warroom.test.ts`. **Files Changed**: * `packages/protocol/tests/warroomNoticeRelay.test.ts` - added focused relay protocol test scaffold and assertions. * `packages/protocol/tests/warroom.test.ts` - updated expected federation frame constants. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T009 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged protocol test scaffold work. **BQC Fixes**: * Contract alignment: protocol tests verify new frame constants, parser envelopes, and safe filtering behavior. *** ### Task T010 - Create focused Worker relay test scaffold **Started**: 2026-06-05 22:49 **Completed**: 2026-06-05 22:50 **Duration**: 1 minutes **Notes**: * Added a focused Worker relay test file with fake Durable Object storage, fake WebSocket pair, authority capture, socket helpers, participant approval helpers, frame parsing helpers, and Notice Board fixtures. * Added a scaffold boot test to verify the harness opens a socket and receives the expected join frame. * Ran `npx vitest run apps/warroom/tests/noticeBoardRelay.test.ts`. **Files Changed**: * `apps/warroom/tests/noticeBoardRelay.test.ts` - added focused Worker relay test scaffold. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T010 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged Worker scaffold work. **BQC Fixes**: * Contract alignment: harness validates the fake socket and authority setup before relay behavior assertions are added. *** ### Task T011 - Extend persisted Notice Board relay hydration **Started**: 2026-06-05 22:50 **Completed**: 2026-06-05 22:53 **Duration**: 3 minutes **Notes**: * Added `noticeBoardNotices` to persisted room state, room initialization, hydration, and persistence. * Hydration filters legacy or unsafe persisted Notice Board history through protocol-owned safe notice filtering before reconnect delivery. * Verified with focused Worker persisted unsafe-history filtering test. **Files Changed**: * `apps/warroom/src/index.ts` - added bounded Notice Board relay history hydration and persistence. * `apps/warroom/tests/noticeBoardRelay.test.ts` - added persisted unsafe-history filtering coverage. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T011 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged hydration work. **BQC Fixes**: * State freshness on re-entry: rehydrated relay history is filtered before reconnect catch-up. * Error information boundaries: unsafe stored payloads are dropped, not echoed. *** ### Task T012 - Record bounded Notice Board relay history **Started**: 2026-06-05 22:50 **Completed**: 2026-06-05 22:53 **Duration**: 3 minutes **Notes**: * Added `recordNoticeBoardMessage` with id-based replacement to prevent duplicate catch-up entries for the same notice id. * Applies protocol safe filtering and deterministic max-history bounds after each accepted message. * Added compact persistence failure handling for Notice Board relay persistence. **Files Changed**: * `apps/warroom/src/index.ts` - added message history recording, bounds, and persistence failure handling. * `apps/warroom/tests/noticeBoardRelay.test.ts` - added bounded history coverage. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T012 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged history recording work. **BQC Fixes**: * Duplicate action prevention: repeated notice ids replace history entries instead of growing duplicate catch-up records. * Failure path completeness: relay persistence failures send a compact socket error to the sender. *** ### Task T013 - Broadcast Notice Board messages to peers only **Started**: 2026-06-05 22:50 **Completed**: 2026-06-05 22:53 **Duration**: 3 minutes **Notes**: * Added `handleNoticeBoardMessage` and `broadcastToPeers` to send direct `notice_board_message` frames to all peers except the sender. * Notice Board relay no longer falls through to the legacy `remote_event` wrapper path. * Verified sender exclusion and no `remote_event` pollution in focused Worker tests. **Files Changed**: * `apps/warroom/src/index.ts` - added sender-excluded Notice Board message relay. * `apps/warroom/tests/noticeBoardRelay.test.ts` - added message relay and sender exclusion coverage. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T013 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged broadcast work. **BQC Fixes**: * Contract alignment: Worker broadcasts canonical Notice Board frames directly instead of wrapping them as legacy federation events. *** ### Task T014 - Relay Notice Board resolutions and update catch-up state **Started**: 2026-06-05 22:50 **Completed**: 2026-06-05 22:53 **Duration**: 3 minutes **Notes**: * Added `handleNoticeResolved` and `applyNoticeResolution` to relay resolution frames to peers and update stored catch-up state for known notice ids. * Unknown notice resolutions still relay safely but do not create new catch-up entries. * Persistence failure handling uses the same compact socket error path as message relay. **Files Changed**: * `apps/warroom/src/index.ts` - added resolution relay and catch-up state updates. * `apps/warroom/tests/noticeBoardRelay.test.ts` - added known and unknown resolution relay coverage. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T014 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged resolution relay work. **BQC Fixes**: * State freshness on re-entry: resolved notices stay resolved in reconnect catch-up. * Failure path completeness: persistence failures are visible to the sender through compact errors. *** ### Task T015 - Send Notice Board catch-up on reconnect **Started**: 2026-06-05 22:50 **Completed**: 2026-06-05 22:53 **Duration**: 3 minutes **Notes**: * `handleSocket` now sends `notice_board_catchup` after legacy safe catch-up when filtered Notice Board history exists. * Catch-up frames are revalidated through `parseWarRoomNoticeBoardCatchupFrame` before sending. * Focused tests verify bounded arrays, deterministic ordering, and `messages` alias parity. **Files Changed**: * `apps/warroom/src/index.ts` - added reconnect Notice Board catch-up send path. * `apps/warroom/tests/noticeBoardRelay.test.ts` - added bounded reconnect catch-up coverage. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T015 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged reconnect catch-up work. **BQC Fixes**: * State freshness on re-entry: reconnecting sockets receive revalidated Notice Board state rather than stale raw history. *** ### Task T016 - Preserve legacy War Room socket behavior **Started**: 2026-06-05 22:50 **Completed**: 2026-06-05 22:53 **Duration**: 3 minutes **Notes**: * Kept legacy `remote_event`, `warroom_pending_catchup`, and `warroom_room_notice` handling unchanged for non-Notice Board frames. * Notice Board frames branch before legacy recent-event recording so they do not pollute old catch-up. * Focused tests verify legacy room notices still use `remote_event` and `warroom_pending_catchup`. **Files Changed**: * `apps/warroom/src/index.ts` - preserved legacy fall-through after Notice Board-specific branches. * `apps/warroom/tests/noticeBoardRelay.test.ts` - added legacy compatibility coverage. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T016 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged legacy compatibility work. **BQC Fixes**: * Contract alignment: new Notice Board relay is additive and does not reinterpret existing War Room event families. *** ### Task T017 - Fail closed on malformed or blocked relay frames **Started**: 2026-06-05 22:50 **Completed**: 2026-06-05 22:53 **Duration**: 3 minutes **Notes**: * Notice Board relay frames are parsed through protocol validation before any Worker history mutation or broadcast. * Malformed, unknown-field, and blocked-field relay frames return compact socket errors and do not appear in reconnect catch-up. * Focused tests cover malformed top-level fields, blocked notice keys, blocked path-like content, and empty catch-up after rejection. **Files Changed**: * `apps/warroom/src/index.ts` - routed Notice Board relay through fail-closed parser branches before mutation. * `apps/warroom/tests/noticeBoardRelay.test.ts` - added malformed and blocked-field coverage. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T017 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged fail-closed handling. **BQC Fixes**: * Trust boundary enforcement: external socket input is validated at the Worker boundary before persistence or broadcast. * Error information boundaries: socket errors expose only stable error codes and compact field names. *** ### Task T018 - Document Notice Board Worker relay boundary **Started**: 2026-06-05 22:54 **Completed**: 2026-06-05 22:55 **Duration**: 1 minutes **Notes**: * Documented `notice_board_message`, `notice_resolved`, and `notice_board_catchup` Worker frames. * Clarified bounded catch-up behavior, direct sender-excluded Notice Board broadcasts, and legacy `remote_event` compatibility. * Added optional external-transfer and no-claim limits for identity, storage, analytics, public replay, auditability, public collaboration safety, and trusted erasure. **Files Changed**: * `apps/warroom/README_warroom.md` - added Notice Board relay contract and privacy boundary documentation. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T018 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged documentation work. **BQC Fixes**: * Error information boundaries: documentation explicitly keeps relay, catch-up, diagnostics, logs, and browser consumption inside the redacted boundary. *** ### Task T019 - Add protocol Notice Board relay tests **Started**: 2026-06-05 22:45 **Completed**: 2026-06-05 22:56 **Duration**: 11 minutes **Notes**: * Added protocol tests for valid message and resolution frames, malformed frames, unknown fields, blocked fields, catch-up bounds, safe notice filtering, recent-event filtering, and no-leak summaries. * Updated the existing protocol War Room test for the expanded federation frame inventory. * Verified with focused protocol tests after formatting. **Files Changed**: * `packages/protocol/tests/warroomNoticeRelay.test.ts` - added protocol relay assertions. * `packages/protocol/tests/warroom.test.ts` - updated safe frame vocabulary expectation. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T019 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged protocol test work. **BQC Fixes**: * Contract alignment: tests verify parser success/failure envelopes and catch-up frame shape. * Error information boundaries: tests verify summaries do not include raw notice ids or resolution text. *** ### Task T020 - Add Worker message relay and catch-up tests **Started**: 2026-06-05 22:50 **Completed**: 2026-06-05 22:56 **Duration**: 6 minutes **Notes**: * Added Worker tests for direct `notice_board_message` relay, sender exclusion, no legacy `remote_event` pollution, bounded history, persisted unsafe-history filtering, and reconnect `notice_board_catchup`. * Verified with focused Worker relay tests and existing Worker compatibility tests. **Files Changed**: * `apps/warroom/tests/noticeBoardRelay.test.ts` - added message relay, bounded history, persisted history filtering, and reconnect catch-up tests. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T020 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged Worker message test work. **BQC Fixes**: * State freshness on re-entry: tests verify reconnect catch-up is bounded and filtered. * Duplicate action prevention: bounded history is verified across more than the cap. *** ### Task T021 - Add Worker resolution and compatibility tests **Started**: 2026-06-05 22:50 **Completed**: 2026-06-05 22:56 **Duration**: 6 minutes **Notes**: * Added Worker tests for `notice_resolved` sender-excluded relay, known-notice catch-up updates, unknown notice resolution relay without catch-up creation, malformed relay frames, blocked fields, and legacy `warroom_room_notice` behavior. * Verified legacy room notice still uses `remote_event` and `warroom_pending_catchup`. **Files Changed**: * `apps/warroom/tests/noticeBoardRelay.test.ts` - added resolution, safety, and legacy compatibility tests. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T021 complete and updated progress. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged Worker resolution and compatibility test work. **BQC Fixes**: * Trust boundary enforcement: tests verify malformed and blocked relay inputs fail before catch-up persistence. * Contract alignment: tests verify legacy frame behavior remains unchanged. *** ### Task T022 - Run focused tests and ASCII/LF validation **Started**: 2026-06-05 22:57 **Completed**: 2026-06-05 22:57 **Duration**: 1 minutes **Notes**: * Ran package type checks for protocol and War Room Worker. * Ran focused protocol and Worker relay tests plus existing War Room protocol and Worker compatibility suites. * Ran ASCII/LF validation across touched source, tests, docs, and active session artifacts. **Files Changed**: * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/tasks.md` - marked T022 and completion checklist complete. * `.spec_system/specs/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md` - logged final verification. **BQC Fixes**: * N/A - final verification task. *** ## Verification * `npm --workspace packages/protocol run typecheck` - passed. * `npm --workspace apps/warroom run typecheck` - passed. * `npx vitest run packages/protocol/tests/warroomNoticeRelay.test.ts packages/protocol/tests/warroom.test.ts apps/warroom/tests/noticeBoardRelay.test.ts apps/warroom/tests/warroom.test.ts` - passed, 63 tests. * ASCII/LF validation - passed across 9 touched source, test, docs, and session files. ## Session Summary * Added protocol-owned Notice Board Worker frame contracts for `notice_board_message`, `notice_resolved`, and `notice_board_catchup`. * Added strict Notice Board relay validation, blocked-field rejection, bounded catch-up parsing, safe notice filtering, and family summaries without raw payload details. * Added Worker Notice Board relay history, sender-excluded direct broadcasts, resolution state updates, and bounded reconnect catch-up while preserving legacy `remote_event` and `warroom_pending_catchup` behavior. * Documented the optional external-transfer boundary and no-claim limits in `apps/warroom/README_warroom.md`. * Added focused protocol and Worker tests for valid relay, malformed input, blocked fields, sender exclusion, bounded history, persisted unsafe-history filtering, reconnect catch-up, resolution relay, unknown resolution, and legacy compatibility. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://faction-os.gitbook.io/faction-os-docs/.spec_system/archive/sessions/phase17-session07-war-room-worker-relay-and-catchup/implementation-notes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.