Method emitEvent

packages/ai-client/src/events.ts:329–387

* Emit an event with automatic clientId and timestamp for client/tool events

(eventName: string, data?: Record<string, any>)

   * Emit an event with automatic clientId and timestamp for client/tool events
   */
  protected emitEvent(eventName: string, data?: Record<string, any>): void {
    const timestamp = Date.now()
    const isUserVisibleEvent =
      eventName.startsWith('text:') ||
      eventName.startsWith('tools:') ||
      eventName.startsWith('structured-output:') ||
      eventName === 'devtools:tool-fixture:applied'
    const includesClientContext =
      eventName.startsWith('client:') ||
      eventName.startsWith('tools:') ||
      eventName.startsWith('text:') ||
      eventName.startsWith('structured-output:') ||
      eventName === 'devtools:tool-fixture:applied'
    const visibility = isUserVisibleEvent ? 'user-visible' : 'client-state'
    const envelopeContext = {
      hookId: this.clientId,
      ...(typeof data?.threadId === 'string'
        ? { threadId: data.threadId }
        : {}),
      ...(typeof data?.runId === 'string' ? { runId: data.runId } : {}),
      ...(typeof data?.streamId === 'string'
        ? { streamId: data.streamId }
        : {}),
      ...(typeof data?.messageId === 'string'
        ? { messageId: data.messageId }
        : {}),
      ...(typeof data?.toolCallId === 'string'
        ? { toolCallId: data.toolCallId }
        : {}),
    }

    // For client:* and tool:* events, automatically add clientId and timestamp
    if (includesClientContext) {
      const envelope = createAIDevtoolsEventEnvelope({
        eventType: eventName,
        clientId: this.clientId,
        ...envelopeContext,
        source: 'client',
        visibility,
        timestamp,
      })
      aiEventClient.emit(eventName as any, {
        ...data,
        ...envelope,
      })
    } else {
      const envelope = createAIDevtoolsEventEnvelope({
        eventType: eventName,
        source: 'client',
        visibility: 'client-state',
        timestamp,
      })
      // For other events, just add timestamp
      aiEventClient.emit(eventName as any, {
        ...data,
        ...envelope,
      })
    }