Documentation / @agentick/core / SessionInspection

Interface: SessionInspection

Defined in: core/src/app/types.ts:1120

Result of session.inspect() - live session state for debugging.

Combines live data (status, queued messages) with snapshot data (last output, model output) and aggregates (total usage).

Example

const session = app.session();
await session.render({ query: "Hello!" });

const info = session.inspect();
console.log('Status:', info.status);
console.log('Tick:', info.currentTick);
console.log('Tokens used:', info.totalUsage.totalTokens);
console.log('Components:', info.components.names);

Properties

components

components: object

Defined in: core/src/app/types.ts:1180

Component tree summary

count

count: number

Number of mounted components

names

names: string[]

Unique component names in the tree

---

currentPhase?

optional currentPhase: ExecutionPhase

Defined in: core/src/app/types.ts:1140

If running, what phase of the tick loop?

---

currentTick

currentTick: number

Defined in: core/src/app/types.ts:1134

Current tick number

---

hooks

hooks: object

Defined in: core/src/app/types.ts:1188

Hook usage summary

byType

byType: Partial<Record<HookType, number>>

Hook count by type

count

count: number

Total number of hooks

---

id

id: string

Defined in: core/src/app/types.ts:1125

Session ID

---

isAborted

isAborted: boolean

Defined in: core/src/app/types.ts:1143

Whether the session has been aborted

---

lastModelOutput

lastModelOutput: { content: ContentBlock[]; stopReason: string; } | null

Defined in: core/src/app/types.ts:1152

Last model response

---

lastOutput

lastOutput: COMInput | null

Defined in: core/src/app/types.ts:1149

Last compiled COM output

---

lastToolCalls

lastToolCalls: ToolCall[]

Defined in: core/src/app/types.ts:1158

Tool calls from last tick

---

lastToolResults

lastToolResults: object[]

Defined in: core/src/app/types.ts:1161

Tool results from last tick

name

name: string

success

success: boolean

toolUseId

toolUseId: string

---

queuedMessages

queuedMessages: Message[]

Defined in: core/src/app/types.ts:1137

Messages queued for the next tick

---

status

status: SessionStatus

Defined in: core/src/app/types.ts:1131

Current session status

---

tickCount

tickCount: number

Defined in: core/src/app/types.ts:1174

Number of completed ticks

---

totalUsage

totalUsage: UsageStats

Defined in: core/src/app/types.ts:1171

Total token usage across all ticks