Reference · Agent Kit

`<agent-kit-chatroom>`

Agent Kit element

You author the messages; the card renders the transcript with a cached-snapshot stamp. Refresh is the CLI lane — the embed never fetches at read time.

A chatroom transcript card. You author the messages; the card renders the transcript with a cached-snapshot stamp. Refresh is the CLI lane — the embed never fetches at read time. optional same-origin JSON path naming a cached snapshot for enrichment (cached-embed preset; a fixture source vetoes any `endpoint`).

optional same-origin API path; NEVER fetched by this element (Live-fetch policy below) — declared for the authoring pipeline only. There is no send path: unlike `sem-chat`, this element has no composer at all.

authored ISO-8601 stamp of the most recent sync (cached-embed preset).

one of `fresh`, `stale`, `error` (cached-embed preset).

`project`, `key`: `string` — the reference quartet (schema `reference` preset) — see Reference attributes below.

per the global attribute catalog (conventions.md §2)

Children

<agent-kit-chatroom-name>`<agent-kit-chatroom-name>` — the room's display name; optional, one (renders as a heading in both modes).
<agent-kit-chat-msg>`<agent-kit-chat-msg>` — one transcript message; author at least one (the count is displayed by the chrome chip, never enforced by a childRule). Content is free-form authored markup (plain text, links, inline sem-* markup — the prose is the message). Message attributes, all strings: - `author` — the speaker label, rendered through the message's CSS `::before` (visible with styles on or off, never part of any extracted record). - `role` — `user` or `assistant`; drives the side accent in CSS. - `at` — authored ISO-8601 stamp of the message (machine format).

Example

agent-kit-chatroom.html

source

              
              <agent-kit-chatroom org="acme" project="semtext" key="room-authoring">
            
                <agent-kit-chatroom-name>Authoring stand-up</agent-kit-chatroom-name>
            
                <agent-kit-chat-msg author="Ada" role="user" at="2026-10-17T09:00:00Z">
            
                  Board's wired — three columns land today.
            
                </agent-kit-chat-msg>
            
                <agent-kit-chat-msg author="Loom" role="assistant" at="2026-10-17T09:01:00Z">
            
                  Watched. The refs scroll their cards into view.
            
                </agent-kit-chat-msg>
            
              </agent-kit-chatroom>

render

No shipped runtime for this element — the authored example renders as plain HTML.

Source: spec/schema/agent-kit/chatroom.md