docs: add comments

legacy/packages/core/src/events/emitters.ts

@@ -6,6 +6,9 @@ import { BaseTask } from '@/task'
 
 import { TaskEvent, TaskStatus } from './event'
 
+/**
+ * Event emitter for task events.
+ */
 export class TaskEventEmitter<
   TInput extends types.TaskInput = void,
   TOutput extends types.TaskOutput = string

legacy/packages/core/src/events/event.ts

@@ -11,10 +11,29 @@ export interface EventPayload {
  * Data required to create a new Event object.
  */
 export interface EventData<T extends EventPayload> {
+  /**
+   * Event identifier
+   */
   id?: string
+
+  /**
+   * Event timestamp
+   */
   timestamp?: Date
+
+  /**
+   * Key-value pairs holding event data.
+   */
   payload?: T
+
+  /**
+   * Version of the event.
+   */
   version?: number
+
+  /**
+   * Event type.
+   */
   type?: string
 }
 
@@ -57,6 +76,9 @@ export class Event<T extends EventPayload> {
     return new Type(data)
   }
 
+  /**
+   * Serializes an event into a JSON string.
+   */
   toJSON(): string {
     return JSON.stringify({
       id: this.id,
@@ -67,6 +89,9 @@ export class Event<T extends EventPayload> {
     })
   }
 
+  /**
+   * Returns a human-readable string representation of an event.
+   */
   toString(): string {
     return `Event { id: ${
       this.id
@@ -85,7 +110,7 @@ export interface TaskEventPayload<TInput, TOutput> extends EventPayload {
   taskStatus: TaskStatus
   taskInputs?: TInput
   taskOutput?: TOutput
-  taskParent?: string
+  parentTaskId?: string
 }
 
 /**
@@ -126,7 +151,7 @@ export class TaskEvent<TInput, TOutput> extends Event<
     return this.payload?.taskOutput ?? ''
   }
 
-  get parent(): string {
+  get parentTaskId(): string {
-    return this.payload?.taskParent ?? 'root'
+    return this.payload?.parentTaskId ?? 'root'
   }
 }