# docs/internals/assistant-citations.md · gitcafe/t3code

[View on GitCafe](https://git.cafe/gitcafe/t3code/blob/517188b3caa135bc09ec0a4f93474ef17c8b5c4f/docs/internals/assistant-citations.md)

Repository: [gitcafe/t3code](https://git.cafe/gitcafe/t3code)

Visibility: public

Requested revision: 517188b3caa135bc09ec0a4f93474ef17c8b5c4f

Requested commit: 517188b3caa135bc09ec0a4f93474ef17c8b5c4f

Commit: 517188b3caa135bc09ec0a4f93474ef17c8b5c4f

Blob: ec830f75bc0313f1385f0851e3968da4544eaadb

Size: 1844 bytes

[Immutable source](https://git.cafe/gitcafe/t3code/blob/517188b3caa135bc09ec0a4f93474ef17c8b5c4f/docs/internals/assistant-citations.md?format=markdown)

```
# Assistant citations

Citations carry the selected excerpt and source identity in ordinary message text.
Drafts, clipboard copies, stashes, and sent messages keep that representation
without a separate citation store. The saved quote remains usable when its source
disappears or changes. The [shared format](../../packages/shared/src/assistantCitations.ts) uses
stable environment IDs without a browser origin, so moving between local, remote,
and tunnel connections does not change a citation's identity.

Source navigation is best effort. [Text selectors](../../apps/web/src/lib/assistantTextSelection.ts)
refer to rendered text after whitespace normalization, measured in UTF-16 units.
They cannot be applied to raw Markdown. The original excerpt keeps its whitespace;
normalization is only for locating it. Repeated text needs an unambiguous context
match, even if one occurrence still sits at the saved offsets. Guessing could
highlight the wrong claim.

Navigation owns the highlight's lifetime across virtual-row remounts. The source
row must be fetched, unfolded, mounted, and measured before quote positioning
takes over from normal timeline scrolling. Remounting must not revive a dismissed
highlight. The [navigation hash](../../apps/web/src/lib/assistantCitationNavigation.ts)
uses base64url because router normalization otherwise decodes whitespace and
source IDs inside the citation URI.

Expand citations with the [shared formatter](../../packages/shared/src/assistantCitations.ts)
before dispatch to a provider adapter. Send the saved excerpt without looking up
the source, distinguish quoted reference material from the user's comment, and
leave persisted messages in their original form. Input limits apply after
expansion as well as before it. A draft that fits as encoded links can exceed the
provider limit once expanded.

```