README

Library for calculating statistics from adachsoft/ai-agent conversation history.

Requirements

• PHP ^8.2
• adachsoft/ai-agent

Installation

composer require adachsoft/ai-agent-stats

Usage

The main entry point is AdachSoft\AiAgentStats\AgentStatsCalculator. It takes a ChatMessageDtoCollection (from adachsoft/ai-agent) and returns an AgentStatsDto with detailed metrics.

use AdachSoft\AiAgentStats\AgentStatsCalculator;
use AdachSoft\AiAgent\PublicApi\Dto\Collection\ChatMessageDtoCollection;

// Assume $messages is your ChatMessageDtoCollection from the agent
/** @var ChatMessageDtoCollection $messages */

$calculator = new AgentStatsCalculator();
$stats = $calculator->calculate($messages);

// Accessing statistics:

// 1. Message counts per role
echo "User messages: " . $stats->messageCountByRole['user'] . PHP_EOL;
echo "Assistant messages: " . $stats->messageCountByRole['assistant'] . PHP_EOL;

// 2. Total size of all messages (content length)
echo "Total size: " . $stats->totalMessagesSize . " bytes" . PHP_EOL;

// 3. Tool usage statistics
foreach ($stats->toolStats as $toolName => $toolStat) {
    echo "Tool: $toolName" . PHP_EOL;
    echo "  - Usage count: " . $toolStat->usageCount . PHP_EOL;
    echo "  - Input size: " . $toolStat->inputSize . " bytes" . PHP_EOL;
    echo "  - Output size: " . $toolStat->outputSize . " bytes" . PHP_EOL;
}

// 4. Advanced metrics
echo "Size of messages with tool calls: " . $stats->messagesWithToolCallsSize . PHP_EOL;
echo "Size of tool output messages: " . $stats->toolRoleMessagesSize . PHP_EOL;

License

MIT