Documentation / @agentick/client / TimelineEntry

Interface: TimelineEntry

Defined in: shared/src/timeline.ts:28

Timeline entry - represents a message or event in the conversation.

Tool calls and results are embedded in message content blocks:

• Tool calls: tool_use blocks in assistant messages
• Tool results: tool_result blocks in tool messages

This unified format is used by both client and backend. Backend extends this with SemanticContentBlock[] and renderer fields.

Properties

id?

optional id: string

Defined in: shared/src/timeline.ts:32

Unique identifier for this timeline entry

---

kind

kind: "message"

Defined in: shared/src/timeline.ts:42

Kind of timeline entry. Currently only 'message' is supported. Additional kinds may be added in the future.

Note: Application events (user actions, system events) use role: 'event' on the message, not a separate kind. This keeps the model simple while allowing events to be distinguished from conversation messages.

---

message

message: Message

Defined in: shared/src/timeline.ts:50

The message content. Tool calls and results are embedded in message.content as blocks:

• Assistant messages may contain tool_use blocks
• Tool messages contain tool_result blocks

---

metadata?

optional metadata: Record<string, unknown>

Defined in: shared/src/timeline.ts:68

Optional metadata

---

tags?

optional tags: string[]

Defined in: shared/src/timeline.ts:63

Tags for categorization and filtering

---

visibility?

optional visibility: "model" | "observer" | "log"

Defined in: shared/src/timeline.ts:58

Visibility control - who can see this entry

• 'model': Visible to the model (default)
• 'observer': Visible to observers/logs but not model
• 'log': Only in logs, not visible to model or observers