Skip to content

Documentation / @agentick/core / COMTimelineEntry

Interface: COMTimelineEntry

Defined in: core/src/com/types.ts:83

COM Timeline Entry - extends base TimelineEntry with backend-specific fields.

Extends the platform-independent TimelineEntry from @agentick/shared with:

  • SemanticContentBlock[] content (format-agnostic, can be rendered)
  • Formatter reference (for formatting)

Extends

Properties

formatter?

optional formatter: Formatter

Defined in: core/src/com/types.ts:89


id?

optional id: string

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

Unique identifier for this timeline entry

Inherited from

TimelineEntry.id


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.

Inherited from

TimelineEntry.kind


message

message: Message & object

Defined in: core/src/com/types.ts:84

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

Type Declaration

content

content: SemanticContentBlock[]

Overrides

TimelineEntry.message


metadata?

optional metadata: Record<string, unknown>

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

Optional metadata

Inherited from

TimelineEntry.metadata


tags?

optional tags: string[]

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

Tags for categorization and filtering

Inherited from

TimelineEntry.tags


tokens?

optional tokens: number

Defined in: core/src/com/types.ts:91

Estimated token count (set by collector/structure-renderer)


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

Inherited from

TimelineEntry.visibility

Released under the ISC License.