Built-in collections

Every entity automatically has these 17 collections, populated by the runtime as the agent operates. Custom state collections defined in EntityDefinition.state are merged with these at creation time.

Source: @durable-streams/darix-runtime -- entity-schema.ts

Collection summary

Collection	Event Type	Interface	Description
runs	run	Run	Agent run lifecycle
steps	step	Step	LLM call step lifecycle
texts	text	Text	Text message lifecycle
textDeltas	text_delta	TextDelta	Incremental text content
toolCalls	tool_call	ToolCall	Tool call lifecycle
reasoning	reasoning	Reasoning	Reasoning block lifecycle
errors	error	ErrorEvent	Diagnostic errors
inbox	message_received	MessageReceived	Inbound messages
wakes	wake	WakeEntry	Wake delivery records
entityCreated	entity_created	EntityCreated	Entity bootstrap metadata
entityStopped	entity_stopped	EntityStopped	Entity shutdown signal
childStatus	child_status	ChildStatusEntry	Child/observed entity status
tags	tags	TagEntry	Entity tags
contextInserted	context_inserted	ContextInserted	Context additions
contextRemoved	context_removed	ContextRemoved	Context removals
manifests	manifest	Manifest	Durable resource manifests
replayWatermarks	replay_watermark	ReplayWatermark	Replay progress tracking

All collections use key as the primary key.

Type definitions

Run

interface Run {
  key: string
  status: "started" | "completed" | "failed"
  finish_reason?: string
}

Step

interface Step {
  key: string
  run_id?: string
  step_number: number
  status: "started" | "completed"
  finish_reason?: string
  model_provider?: string
  model_id?: string
  duration_ms?: number
}

Text

interface Text {
  key: string
  run_id?: string
  status: "streaming" | "completed"
}

TextDelta

interface TextDelta {
  key: string
  text_id: string
  run_id: string
  delta: string
}

ToolCall

interface ToolCall {
  key: string
  run_id?: string
  tool_name: string
  status: "started" | "args_complete" | "executing" | "completed" | "failed"
  args?: unknown
  result?: unknown
  error?: string
  duration_ms?: number
}

Reasoning

interface Reasoning {
  key: string
  status: "streaming" | "completed"
}

ErrorEvent

interface ErrorEvent {
  key: string
  error_code: string
  message: string
  run_id?: string
  step_id?: string
  tool_call_id?: string
}

MessageReceived

interface MessageReceived {
  key: string
  from: string
  payload?: unknown
  timestamp: string
  message_type?: string
}

WakeEntry

interface WakeEntry {
  key: string
  timestamp: string
  source: string
  timeout: boolean
  changes: WakeChangeEntry[]
  finished_child?: WakeFinishedChildEntry
  other_children?: WakeOtherChildEntry[]
}

interface WakeChangeEntry {
  collection: string
  kind: "insert" | "update" | "delete"
  key: string
}

interface WakeFinishedChildEntry {
  url: string
  type: string
  run_status: "completed" | "failed"
  response?: string // concatenated text deltas from the finished run
  error?: string // error message(s) if run_status is "failed"
}

interface WakeOtherChildEntry {
  url: string
  type: string
  status: "spawning" | "running" | "idle" | "stopped"
}

EntityCreated

interface EntityCreated {
  key: string
  entity_type: string
  timestamp: string
  args: Record<string, JsonValue>
  parent_url?: string
}

EntityStopped

interface EntityStopped {
  key: string
  timestamp: string
  reason?: string
}

ChildStatusEntry

interface ChildStatusEntry {
  key: string
  entity_url: string
  entity_type: string
  status: "spawning" | "running" | "idle" | "stopped"
}

TagEntry

interface TagEntry {
  key: string
  value: string
}

ContextInserted

interface ContextInserted {
  key: string
  id: string
  name: string
  attrs: Record<string, string | number | boolean>
  content: string
  timestamp: string
}

ContextRemoved

interface ContextRemoved {
  key: string
  id: string
  name: string
  timestamp: string
}

Manifest

Discriminated union by kind:

type Manifest =
  | ManifestChildEntry
  | ManifestSourceEntry
  | ManifestSharedStateEntry
  | ManifestEffectEntry
  | ManifestContextEntry
  | ManifestCronScheduleEntry
  | ManifestFutureSendScheduleEntry

interface ManifestChildEntry {
  key: string
  kind: "child"
  id: string
  entity_type: string
  entity_url: string
  wake?: WakeConfig
  observed: boolean
}

interface ManifestSourceEntry {
  key: string
  kind: "source"
  sourceType: string
  sourceRef: string
  wake?: WakeConfig
  config: Record<string, unknown>
}

interface ManifestSharedStateEntry {
  key: string
  kind: "shared-state"
  id: string
  mode: "create" | "connect"
  collections: Record<string, { type: string; primaryKey: string }>
  wake?: WakeConfig
}

interface ManifestEffectEntry {
  key: string
  kind: "effect"
  id: string
  function_ref: string
  config: unknown
}

interface ManifestContextEntry {
  key: string
  kind: "context"
  id: string
  name: string
  attrs: Record<string, string | number | boolean>
  content: string
  insertedAt: number
}

interface ManifestCronScheduleEntry {
  key: string
  kind: "schedule"
  id: string
  scheduleType: "cron"
  expression: string
  timezone?: string
  payload?: unknown
  wake?: WakeConfig
}

interface ManifestFutureSendScheduleEntry {
  key: string
  kind: "schedule"
  id: string
  scheduleType: "future_send"
  fireAt: string
  targetUrl: string
  payload: unknown
  producerId: string
  from?: string
  messageType?: string
  status?: "pending" | "sent" | "failed"
  sentAt?: string
  failedAt?: string
  lastError?: string
}

ReplayWatermark

interface ReplayWatermark {
  key: string
  source_id: string
  offset: string
  updated_at: string
}