ai_session_tool_usages

Individual tool invocations within an AI session. Metadata only; tool arguments and results are never captured.

id

Primary key
Unique identifier for the row.

ai_session_id

Foreign key
ID of the associated AI session.

external_id

Foreign key
External identifier for the tool invocation, provided by the AI tool. Unique within the session.

tool_name

string
Name of the invoked tool as reported by the AI tool.

tool_type

string
Normalized classification of the invocation ("mcp", "skill", or "other").

started_at

date
Timestamp when the tool invocation started. Null when the AI tool did not report one.

completed_at

date
Timestamp when the tool invocation completed. Null when no completion was recorded.

duration_ms

number
Elapsed duration of the tool invocation in milliseconds. Null when it could not be determined.

status

string
Outcome of the tool invocation ("success" or "error"). Only populated when the AI tool reports it explicitly.

model

string
AI model that issued the tool invocation.

row_created_at

date
Timestamp when the record was created.

row_updated_at

date
Timestamp when the record was last updated.