feat: add tool call event

[chr-hertel]

Closes #168

[chr-hertel]

Tests currently failing since i moved tool result conversion into the chain processor, but would that be a way to go for you @OskarStark ?

final class SpecificToolCallSubscriber implement EventSubscriberInterface
{
    public static function getSubscribedEvents()
    {
        return [
            ToolCallExecuted::class => 'handleToolCall',
        ];
    }

    public function handleToolCall(ToolCallExecuted $event): void
    {
        foreach ($event->toolCallResults as $toolCallResult) {
            if ('xyz' === $toolCallResult->toolCall->name) {
                $event->response = new StructuredResponse($toolCallResult->result);
            }
        }
    }
}

See example:
https://github.com/php-llm/llm-chain/blob/f096dba8e5b049ef4fa4363ade2af31c26e86568/examples/toolbox-weather-event.php#L26-L47

[OskarStark]

Uhhhhhhh that looks nice 😍 will have a detailed look when on my Mac 💻👍🏻

Thanks for taking time

[OskarStark]

The event name is singular and then you iterate over all toolCallResults (plural), that feels weird. Shouldn't we throw an event for every ToolCall which was executed?

Otherwise rename it to ToolCallsExecuted?

Or am I missing sth.?

[chr-hertel]

you're right. should be plural

[OskarStark]

I like it 👍 Looks like I can achieve my goals with it 🕺