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.