Function markEventSeen

packages/ai-devtools/src/store/hook-registry.ts:192–250

(
  state: HookRegistryState,
  eventName: string,
  event: Partial<AIDevtoolsEventEnvelope> & {
    runtimeId?: string
    timestamp?: number
  },
)

}

export function markEventSeen(
  state: HookRegistryState,
  eventName: string,
  event: Partial<AIDevtoolsEventEnvelope> & {
    runtimeId?: string
    timestamp?: number
  },
): boolean {
  let key: string
  if (event.eventId) {
    key = event.eventId
  } else {
    key = [
      eventName,
      event.source ?? 'unknown',
      event.visibility ?? 'unknown',
      event.runtimeId ?? 'no-runtime',
      event.hookId ?? event.clientId ?? 'no-hook',
      event.threadId ?? 'no-thread',
      event.runId ?? 'no-run',
      event.messageId ?? 'no-message',
      event.toolCallId ?? 'no-tool-call',
      event.timestamp ?? 'no-time',
    ].join(':')
    // If every identifying field fell back to its literal sentinel the synthesised
    // key is just `eventName:unknown:unknown:no-runtime:...` — useful for very
    // little. Warn so it's obvious in the console why deduplication may be
    // collapsing distinct events together.
    if (
      !event.source &&
      !event.visibility &&
      !event.runtimeId &&
      !event.hookId &&
      !event.clientId &&
      !event.threadId &&
      !event.runId &&
      !event.messageId &&
      !event.toolCallId &&
      !event.timestamp
    ) {
      console.warn(
        `[ai-devtools] dedupe key for "${eventName}" has no identifying fields; events may collide.`,
      )
    }
  }

  if (state.seenEventIds[key]) {
    return false
  }
  state.seenEventIds[key] = true
  state.seenEventIdOrder.push(key)
  if (state.seenEventIdOrder.length > SEEN_EVENT_IDS_CAP) {
    const evicted = state.seenEventIdOrder.shift()
    if (evicted !== undefined) {
      delete state.seenEventIds[evicted]
    }
  }
  return true