CR. Streaming events. Update description for model and event Id

Author: sdubov

agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/model/events/llmStreamingEvents.kt

@@ -12,11 +12,11 @@ import kotlinx.serialization.Serializable
  * This event holds metadata related to the initiation of the LLM streaming process, including
  * details about the run, the input prompt, the model used, and the tools involved.
  *
- * @property runId Unique identifier for the LLM run.
- * @property prompt The input prompt provided for the LLM operation.
- * @property model The name or identifier of the language model being used.
- * @property tools A list of associated tools or resources that are part of the operation.
- * @property eventId Unique identifier for this type of event, defaulting to the name of the starting event class.
+ * @property runId Unique identifier for the LLM run;
+ * @property prompt The input prompt provided for the LLM operation;
+ * @property model The description of the LLM model used during the call. Use the format: 'llm_provider:model_id';
+ * @property tools A list of associated tools or resources that are part of the operation;
+ * @property eventId A string representing the event type;
  * @property timestamp The time when the event occurred, represented in epoch milliseconds.
  */
 @Serializable
@@ -36,10 +36,10 @@ public data class LLMStreamingStartingEvent(
  * frames of data are sent incrementally. The event contains details about the specific
  * frame received, as well as metadata related to the event's timing and identity.
  *
- * @property runId The unique identifier for the LLM run or session associated with this event.
+ * @property runId The unique identifier for the LLM run or session associated with this event;
  * @property frame The frame data received as part of the streaming response. This can include textual
- *                 content, tool invocations, or signaling the end of the stream.
- * @property eventId A string representing the unique identifier of this event type.
+ *                 content, tool invocations, or signaling the end of the stream;
+ * @property eventId A string representing the event type;
  * @property timestamp The timestamp of when the event was created, represented in milliseconds since the Unix epoch.
  */
 @Serializable
@@ -57,11 +57,10 @@ public data class LLMStreamingFrameReceivedEvent(
  * It includes information such as the unique identifier of the operation run, a detailed
  * error description, and inherits common properties such as event ID and timestamp.
  *
- * @property runId A unique identifier representing the specific operation or run in which the failure occurred.
+ * @property runId A unique identifier representing the specific operation or run in which the failure occurred;
  * @property error An instance of [AIAgentError], containing information about the error encountered, including its
- *                 message, stack trace, and cause, if available.
- * @property eventId A string identifier representing the event type. By default, it is set to the simple class name
- *                   of the `LLMCallStartingEvent`.
+ *                 message, stack trace, and cause, if available;
+ * @property eventId A string representing the event type;
  * @property timestamp A timestamp indicating when the event occurred, represented in milliseconds since the Unix epoch.
  */
 @Serializable
@@ -75,11 +74,11 @@ public data class LLMStreamingFailedEvent(
 /**
  * Represents an event that occurs when the streaming process of a Large Language Model (LLM) call is completed.
  *
- * @property runId The unique identifier of the LLM run.
- * @property prompt The prompt associated with the LLM call.
- * @property model The name of the LLM model used during the call.
- * @property tools A list of tools used or invoked during the LLM call.
- * @property eventId The identifier for this specific event, defaulting to the class name of `LLMCallStartingEvent`.
+ * @property runId The unique identifier of the LLM run;
+ * @property prompt The prompt associated with the LLM call;
+ * @property model The description of the LLM model used during the call. Use the format: 'llm_provider:model_id';
+ * @property tools A list of tools used or invoked during the LLM call;
+ * @property eventId A string representing the event type;
  * @property timestamp The timestamp indicating when the event occurred, represented in milliseconds since the epoch, defaulting to the current system time.
  */
 @Serializable