AIDK API Reference / aidk-shared / TimelineEntry

Interface: TimelineEntry

Defined in: packages/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.

Extended by

• COMTimelineEntry

Properties

Property	Type	Description	Defined in
id?	string	Unique identifier for this timeline entry	packages/shared/src/timeline.ts:32
kind	"message" | "event"	Kind of timeline entry - 'message': Regular conversation message (user, assistant, system, tool) - 'event': Application event (user actions, system events, state changes)	packages/shared/src/timeline.ts:39
message	Message	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	packages/shared/src/timeline.ts:47
metadata?	Record<string, unknown>	Optional metadata	packages/shared/src/timeline.ts:65
tags?	string[]	Tags for categorization and filtering	packages/shared/src/timeline.ts:60
visibility?	"model" | "observer" | "log"	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	packages/shared/src/timeline.ts:55