package protocol // ChatShown is the pushed frame type for an item a chat's model showed the // operator through the Pipelines tools (show_file, show_image, show_html, // show_diff, notify). The chat_subscribe reply carries the retained list in the same // ChatShown field. const ChatShown = "chat_shown" // The ChatShownItem kinds. const ( ChatShownFile = "file" ChatShownImage = "image" ChatShownHTML = "html" ChatShownDiff = "diff" ChatShownNotify = "notify" ) // ChatShownLimit bounds the items retained per chat, and ChatShownHTMLBudget // the HTML and diff bytes kept across them: older documents and diffs beyond // it keep their entry but drop the body (Expired). const ( ChatShownLimit = 100 ChatShownHTMLBudget = 2 << 20 ) // ChatShownFrame is one chat's shown items, oldest first. type ChatShownFrame struct { SessionID string `json:"session_id"` Items []ChatShownItem `json:"items"` } // ChatShownItem is one entry. A file or image Path is an absolute path on the // chat's own machine, served by that machine's /files endpoint; URL is an // https image address the client loads without credentials. type ChatShownItem struct { ID string `json:"id"` Kind string `json:"kind"` CreatedAt int64 `json:"created_at"` Title string `json:"title,omitempty"` Path string `json:"path,omitempty"` Name string `json:"name,omitempty"` Size int64 `json:"size,omitempty"` Mime string `json:"mime,omitempty"` URL string `json:"url,omitempty"` Alt string `json:"alt,omitempty"` HTML string `json:"html,omitempty"` HTMLBytes int `json:"html_bytes,omitempty"` // Diff is a show_diff item's repository comparison; DiffBytes is the size // of its patches, counted against ChatShownHTMLBudget. Diff *ChatShownDiffBody `json:"diff,omitempty"` DiffBytes int `json:"diff_bytes,omitempty"` // HeightHint is the model's preferred inline height in logical pixels. HeightHint int `json:"height_hint,omitempty"` Expired bool `json:"expired,omitempty"` Message string `json:"message,omitempty"` Priority string `json:"priority,omitempty"` Delivered bool `json:"delivered,omitempty"` // Detail says why a notification was not delivered. Detail string `json:"detail,omitempty"` } // ChatShownDiffBody is one Git comparison a chat's model showed: the work tree // (or HEAD when CommittedOnly) of Repo against BaseCommit, which is HEAD when // Base is empty and the merge base with Base otherwise. Changes uses the same // per-file shape as a run's recorded changes; it is nil once Expired. type ChatShownDiffBody struct { Repo string `json:"repo"` Base string `json:"base,omitempty"` BaseCommit string `json:"base_commit,omitempty"` Head string `json:"head,omitempty"` CommittedOnly bool `json:"committed_only,omitempty"` Files int `json:"files"` Additions int `json:"additions"` Deletions int `json:"deletions"` Changes *StageFileChanges `json:"changes,omitempty"` }