Skip to content

@usine/engine/transcript

All persisted rows for one Attempt, in append order.

  • Schema.Class

new TranscriptAllQuery(…args): TranscriptAllQuery

Parameter Type
…args [props: object, options?: MakeOptions]

TranscriptAllQuery

readonly attemptId: string & Brand<"AttemptId">


One append-only row of an Attempt transcript.

  • Schema.Class

new TranscriptEntry(…args): TranscriptEntry

Parameter Type
…args [props: object, options?: MakeOptions]

TranscriptEntry

readonly attemptId: string & Brand<"AttemptId">

readonly direction: "inbound" | "outbound"

readonly envelope: OutboundEnvelope | InboundEnvelope | { _tag: "OutboundEnvelope"; attemptId: string & Brand<"AttemptId">; payload: Started | SessionEvent | Final | Failed | Interrupted | InterventionApplied | InterventionRejected; sentAt: Utc; sequence: number & Brand<"AttemptChannelSequence">; version: 5 | 6; } | { _tag: "InboundEnvelope"; attemptId: string & Brand<"AttemptId">; operator: string; payload: Steer | Interrupt | OperatorMessage | Release | Cancel; sentAt: Utc; sequence: number & Brand<"AttemptChannelSequence">; target: ParentTarget | ChildTarget; version: 5 | 6; } | { _tag: "OutboundEnvelope"; attemptId: string & Brand<"AttemptId">; payload: Started | SessionEvent | Final | Failed | Interrupted | InterventionApplied | InterventionRejected; sentAt: Utc; sequence: number & Brand<"AttemptChannelSequence">; version: 3 | 4; } | { _tag: "InboundEnvelope"; attemptId: string & Brand<"AttemptId">; payload: Steer | Interrupt; sentAt: Utc; sequence: number & Brand<"AttemptChannelSequence">; version: 3 | 4; }

readonly receivedAt: Utc

readonly sequence: number & Brand<"TranscriptSequence">


The newest bounded page before a cursor, returned in append order for loading earlier activity.

  • Schema.Class

new TranscriptPageQuery(…args): TranscriptPageQuery

Parameter Type
…args [props: object, options?: MakeOptions]

TranscriptPageQuery

readonly attemptId: string & Brand<"AttemptId">

readonly before: Option<number & Brand<"TranscriptSequence">>

Earliest row already loaded, excluded from the response; None starts at the current tail.

readonly limit: number

Maximum number of earlier rows to return.


Launch metadata, latest lifecycle, and supervision receipt per session, independent of the visible page.

  • Schema.Class

new TranscriptSessionsQuery(…args): TranscriptSessionsQuery

Parameter Type
…args [props: object, options?: MakeOptions]

TranscriptSessionsQuery

readonly attemptId: string & Brand<"AttemptId">


The next bounded set of rows after a cursor, in append order, for following an Attempt’s activity.

  • Schema.Class

new TranscriptTailQuery(…args): TranscriptTailQuery

Parameter Type
…args [props: object, options?: MakeOptions]

TranscriptTailQuery

readonly after: number & Brand<"TranscriptSequence">

Last row already received; the response excludes this row.

readonly attemptId: string & Brand<"AttemptId">

readonly limit: number

Maximum number of newer rows to return.

TranscriptQuery = typeof TranscriptQuery.Type

Selects a complete Attempt transcript, newer activity, or an earlier page.


TranscriptSequence = typeof TranscriptSequence.Type

Global append order of the persisted transcript. Distinct from AttemptChannel.Sequence, which orders messages within one Attempt’s channel direction.

const TranscriptQuery: Schema.Union<readonly [typeof TranscriptAllQuery, typeof TranscriptSessionsQuery, typeof TranscriptTailQuery, typeof TranscriptPageQuery]>

Selects a complete Attempt transcript, newer activity, or an earlier page.


const TranscriptSequence: Schema.brand<Schema.Int, "TranscriptSequence">

Global append order of the persisted transcript. Distinct from AttemptChannel.Sequence, which orders messages within one Attempt’s channel direction.