Function validateAgentRunEvent

core/telemetry/schema.js:20–64

(entry)

const TRUST_OVERRIDE_VALUES = ['novice', 'familiar', 'trusted'];

function validateAgentRunEvent(entry) {
  const errors = [];

  if (!entry || typeof entry !== 'object') {
    return { valid: false, errors: ['entry must be an object'] };
  }

  if (typeof entry.timestamp !== 'string' || !entry.timestamp) {
    errors.push('timestamp must be a non-empty string (ISO 8601)');
  }

  if (!AGENT_RUN_EVENT_TYPES.includes(entry.event)) {
    errors.push(`event must be one of: ${AGENT_RUN_EVENT_TYPES.join(', ')} — got: ${entry.event}`);
  }

  if (typeof entry.agent !== 'string' || !entry.agent) {
    errors.push('agent must be a non-empty string');
  }

  if (entry.session !== null && entry.session !== undefined && typeof entry.session !== 'string') {
    errors.push('session must be a string or null');
  }

  if (entry.campaign_slug !== null && entry.campaign_slug !== undefined && typeof entry.campaign_slug !== 'string') {
    errors.push('campaign_slug must be a string or null');
  }

  if (entry.duration_ms !== null && entry.duration_ms !== undefined && typeof entry.duration_ms !== 'number') {
    errors.push('duration_ms must be a number or null');
  }

  if (
    entry.status !== null &&
    entry.status !== undefined &&
    !AGENT_RUN_STATUS_VALUES.includes(entry.status)
  ) {
    errors.push(`status must be one of: ${AGENT_RUN_STATUS_VALUES.join(', ')} or null — got: ${entry.status}`);
  }

  if (entry.meta !== null && entry.meta !== undefined && typeof entry.meta !== 'object') {
    errors.push('meta must be an object or null');
  }

  return { valid: errors.length === 0, errors };
}

function validateHookTimingEvent(entry) {
  const errors = [];