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.