threecode/transcript

High-level transcript items for append-only terminal history.

Controllers construct these semantic items and append them through the fat-prompt runtime. Formatters in display/tool modules can still build item bodies, but this module owns item markers, trimming, and item separators.

Types

TranscriptItem = object
  kind*: TranscriptKind
  marker*: string
  title*: string
  body*: string
  attachSeparator*: bool
TranscriptKind = enum
  tiUserPrompt, tiAssistant, tiTool, tiCommand

Procs

proc appendItem(item: TranscriptItem; restoreEditor = true;
                beforeRepaint: proc () = nil; reserveFooter = true;
                prefixBoundary = false) {....raises: [IOError, Exception], tags: [
    ReadEnvEffect, ReadIOEffect, TimeEffect, WriteIOEffect, WriteDirEffect,
    RootEffect], forbids: [].}
proc assistantItem(content: string): TranscriptItem {....raises: [], tags: [],
    forbids: [].}
proc commandItem(name, body: string; ok = true): TranscriptItem {....raises: [],
    tags: [], forbids: [].}
proc formatItem(item: TranscriptItem): string {.
    ...raises: [IOError, IOError, IOError], tags: [ReadEnvEffect, ReadIOEffect,
    TimeEffect, WriteIOEffect, WriteDirEffect], forbids: [].}
proc plainCommandBodyBytes(body: string): string {....raises: [], tags: [],
    forbids: [].}
proc toolItem(act: Action; res: string; code, idx: int; diff = ""; elapsedS = -1): TranscriptItem {.
    ...raises: [], tags: [ReadEnvEffect], forbids: [].}
proc userPromptItem(line: string): TranscriptItem {....raises: [], tags: [],
    forbids: [].}