click.aligned.chat.session

aligned.click

Documentation

A published conversation with an agent. The container only: the turns are separate click.aligned.chat.message records pointing back at this one, so a session grows without ever being rewritten.

main record

A published conversation with an agent. The container only: the turns are separate click.aligned.chat.message records pointing back at this one, so a session grows without ever being rewritten.

Record Key tid Timestamp-based ID

Properties

createdAt string datetime Required

When the conversation started, not when it was published.

description string Optional

Optional framing: what was being explored, and why.

maxLength: 12000 bytesmaxGraphemes: 3000 graphemes
discussion string at-uri Optional

A Bluesky post where this conversation is being discussed. Records like these are durable but silent — nothing on the network is notified when one is written — so conversation about them has to happen where conversation already happens. Naming the post rather than embedding the replies keeps the two separate: the record is the artifact, the thread is what people said about it, and either can be deleted without taking the other with it.

title string Optional

What the conversation was about. May be written after the fact, which is why messages link here by at-uri rather than by strongRef — editing this must not dangle them.

maxLength: 640 bytesmaxGraphemes: 128 graphemes
View raw schema
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "createdAt"
    ],
    "properties": {
      "title": {
        "type": "string",
        "maxLength": 640,
        "description": "What the conversation was about. May be written after the fact, which is why messages link here by at-uri rather than by strongRef — editing this must not dangle them.",
        "maxGraphemes": 128
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "When the conversation started, not when it was published."
      },
      "discussion": {
        "type": "string",
        "format": "at-uri",
        "description": "A Bluesky post where this conversation is being discussed. Records like these are durable but silent — nothing on the network is notified when one is written — so conversation about them has to happen where conversation already happens. Naming the post rather than embedding the replies keeps the two separate: the record is the artifact, the thread is what people said about it, and either can be deleted without taking the other with it."
      },
      "description": {
        "type": "string",
        "maxLength": 12000,
        "description": "Optional framing: what was being explored, and why.",
        "maxGraphemes": 3000
      }
    }
  },
  "description": "A published conversation with an agent. The container only: the turns are separate click.aligned.chat.message records pointing back at this one, so a session grows without ever being rewritten."
}

Lexicon Garden

@