Function traceWsIn

apps/kimi-web/src/debug/trace.ts:268–296

(frame: unknown)

/** Inbound server frame — control frames and event frames alike. */
export function traceWsIn(frame: unknown): void {
  if (!isTraceEnabled()) return;
  const f = (frame ?? {}) as Record<string, unknown>;
  const type = typeof f['type'] === 'string' ? (f['type'] as string) : '(unknown)';
  const sessionId =
    typeof f['session_id'] === 'string'
      ? (f['session_id'] as string)
      : typeof (f['payload'] as Record<string, unknown> | undefined)?.['session_id'] === 'string'
        ? ((f['payload'] as Record<string, unknown>)['session_id'] as string)
        : undefined;
  const seq = typeof f['seq'] === 'number' ? (f['seq'] as number) : undefined;
  const offset = typeof f['offset'] === 'number' ? (f['offset'] as number) : undefined;
  const bits = [
    sessionId,
    seq !== undefined ? `seq=${seq}` : undefined,
    offset !== undefined ? `offset=${offset}` : undefined,
    f['volatile'] === true ? 'volatile' : undefined,
  ].filter(Boolean);
  push({
    source: 'ws',
    kind: 'ws:in',
    eventType: type,
    sessionId,
    seq,
    offset,
    label: `← ${type}${bits.length > 0 ? ` (${bits.join(' ')})` : ''}`,
    detail: detailOf(f['payload']),
  });
}

// ---------------------------------------------------------------------------
// Client-side log capture — so the exported troubleshooting log includes the