Start tracking a new chat session. Call this ONCE at the beginning of every chat session.

Captures a snapshot of current plan credits and wall-clock time so that subsequent calls to get_session_stats can calculate deltas.

Returns the session_id and starting credit balance.

Log an agent interaction (turn) within the session.

Call this after each agent turn to record thinking time. If thinking_seconds is not provided, records a zero-duration ping (useful for just updating the 'last activity' timestamp).

Get current metrics for a chat session.

Returns:

• session_credits: Credits consumed during this session (delta from start)

• total_thinking_time: Cumulative agent processing time

• wall_clock_time: Total time since session started

• interaction_count: Number of agent turns logged

Get overall Kiro plan usage for the current billing cycle.

Returns plan limit, total credits used, remaining, overage details, and reset date. This is the full-cycle view (not session-specific).

Get a formatted summary suitable for pasting into Jira comments, PR descriptions, or other documentation.