Skip to content

Documentation / @agentick/core / SessionInspection

Interface: SessionInspection ​

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

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 ​

typescript
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:1172

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:1132

If running, what phase of the tick loop?


currentTick ​

currentTick: number

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

Current tick number


hooks ​

hooks: object

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

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:1117

Session ID


isAborted ​

isAborted: boolean

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

Whether the session has been aborted


lastModelOutput ​

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

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

Last model response


lastOutput ​

lastOutput: COMInput | null

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

Last compiled COM output


lastToolCalls ​

lastToolCalls: ToolCall[]

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

Tool calls from last tick


lastToolResults ​

lastToolResults: object[]

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

Tool results from last tick

name ​

name: string

success ​

success: boolean

toolUseId ​

toolUseId: string


queuedMessages ​

queuedMessages: Message[]

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

Messages queued for the next tick


status ​

status: SessionStatus

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

Current session status


tickCount ​

tickCount: number

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

Number of completed ticks


totalUsage ​

totalUsage: UsageStats

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

Total token usage across all ticks

Released under the ISC License.