Documentation / @agentick/shared / DTContextUpdateEvent

Interface: DTContextUpdateEvent

Defined in: devtools.ts:429

Emitted after each tick with context utilization info. Enables DevTools and React UI to show real-time context tracking.

Extends

• DevToolsEventBase

Properties

cacheCreationTokens?

optional cacheCreationTokens: number

Defined in: devtools.ts:452

Tokens written to KV cache this tick (provider-dependent)

---

cachedInputTokens?

optional cachedInputTokens: number

Defined in: devtools.ts:450

Input tokens served from KV cache (provider-dependent)

---

cacheHitRatio?

optional cacheHitRatio: number

Defined in: devtools.ts:454

Ratio of cached to total input tokens (0-1)

---

contextWindow?

optional contextWindow: number

Defined in: devtools.ts:440

Context window size in tokens

---

cumulativeUsage?

optional cumulativeUsage: object

Defined in: devtools.ts:464

Cumulative usage across all ticks

inputTokens

inputTokens: number

outputTokens

outputTokens: number

ticks

ticks: number

totalTokens

totalTokens: number

---

executionId

executionId: string

Defined in: devtools.ts:32

UUID of the execution context

Inherited from

DevToolsEventBase.executionId

---

inputTokens

inputTokens: number

Defined in: devtools.ts:442

Input tokens used this tick

---

isReasoningModel?

optional isReasoningModel: boolean

Defined in: devtools.ts:460

---

maxOutputTokens?

optional maxOutputTokens: number

Defined in: devtools.ts:456

Max output tokens

---

modelId

modelId: string

Defined in: devtools.ts:434

Model ID (e.g., "gpt-4o", "claude-3-5-sonnet-20241022")

---

modelName?

optional modelName: string

Defined in: devtools.ts:436

Human-readable model name

---

outputTokens

outputTokens: number

Defined in: devtools.ts:444

Output tokens generated this tick

---

parentExecutionId?

optional parentExecutionId: string

Defined in: devtools.ts:45

Parent execution ID for nested executions (fork, spawn, component_tool)

Inherited from

DevToolsEventBase.parentExecutionId

---

procedureId?

optional procedureId: string

Defined in: devtools.ts:47

Current procedure ID

Inherited from

DevToolsEventBase.procedureId

---

provider?

optional provider: string

Defined in: devtools.ts:438

Provider name

---

requestId?

optional requestId: string

Defined in: devtools.ts:43

Request ID for this execution context

Inherited from

DevToolsEventBase.requestId

---

sequence

sequence: number

Defined in: devtools.ts:34

Monotonically increasing sequence number from the source session

Inherited from

DevToolsEventBase.sequence

---

sessionId

sessionId: string

Defined in: devtools.ts:432

Session ID

---

supportsToolUse?

optional supportsToolUse: boolean

Defined in: devtools.ts:459

---

supportsVision?

optional supportsVision: boolean

Defined in: devtools.ts:458

Model capabilities

---

tenantId?

optional tenantId: string

Defined in: devtools.ts:51

Tenant ID from context (for multi-tenant dashboards)

Inherited from

DevToolsEventBase.tenantId

---

tick

tick: number

Defined in: devtools.ts:462

Current tick number

---

timestamp

timestamp: number

Defined in: devtools.ts:36

Unix timestamp in milliseconds

Inherited from

DevToolsEventBase.timestamp

---

totalTokens

totalTokens: number

Defined in: devtools.ts:446

Total tokens this tick

---

traceId?

optional traceId: string

Defined in: devtools.ts:41

Trace ID for distributed tracing correlation

Inherited from

DevToolsEventBase.traceId

---

type

type: "context_update"

Defined in: devtools.ts:430

Discriminator for event type

Overrides

DevToolsEventBase.type

---

userId?

optional userId: string

Defined in: devtools.ts:49

User ID from context (for attribution and multi-tenant filtering)

Inherited from

DevToolsEventBase.userId

---

utilization?

optional utilization: number

Defined in: devtools.ts:448

Context utilization percentage (0-100)